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PREMESSA 



11 processore per la periferica video (VDP) originariamente compreso nelle 
specifiche MSX era il Texas Instruments 9929A. Questa unità è stata sosti- 
tuita dalla più avanzata 9129. Ai fini della programmazione, però, le due 
unità sono da considerarsi identiche. 

Il VDP costruisce l’immagine video a partire da numerose tabelle di dati 
localizzate nei 16K della RAM dedicata al video. Le locazioni delle tabelle 
in ciascuna delle modalità di visualizzazione vengono ritornate per mezzo 
della variabile di sistema BASE(X). Noi pensiamo che ciò sia una caratte- 
ristica comune a tutti i modelli con la Versione 1 del BASIC. Quindi le sud- 
dette locazioni della tabella, riportate nell’Appendice C, verranno ritenute 
valide negli esempi più significativi. 

Il BASIC MSX consente ai programmi di utilizzare file in diversi e nu- 
merosi formati. Un’istruzione di cui non esiste documentazione, RUN “nome 
file”, può forse essere utilizzata per caricare in memoria e far eseguire un 
programma memorizzato in formato ASCII (al posto di LOAD “nome fi- 
le”, R). Al momento di andare in stampa non siamo in grado di conferma- 
re lo stato di messa a punto di quest’istruzione e di conseguenza non verrà 
fatto alcun ulteriore riferimento ad essa. 
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Capitolo 1 

INTRODUZIONE 

Generalità. Organizzazione della memoria. 

L’interfaccia nastro. Le modalità di visualizzazione. 

II processore video (V.D.P.) e l’integrato per la produzione 
di suoni. 



Generalità 

Lo standard MSX è una specifica introdotta a metà del 1983 dalla Micro- 
soft Ine.. Esso comprende il linguaggio BASIC, il sistema operativo e alcu- 
ni connettori esterni (che comprendono una cartuccia ROM e la porta per 
il joystick). Il software è intercambiabile tra tutte le macchine MSX (a pat- 
to che vi sia sufficiente memoria disponibile). Tutti i modelli (tranne lo Spec- 
travideo SVI-728 e lo Yamaha CX5M) sono dotati di alimentazione inter- 
na. Sono altresì rigidamente specificate alcune caratteristiche non richieste 
nel sistema di base: una porta parallela del tipo “Centronics” per stam- 
pante, una seconda porta per il joystick, una interfaccia RS-232C e un se- 
condo alloggiamento per cartucce di memoria. 

Il sistema operativo (MSX-DOS) usa per i dischi il medesimo formato 
dell’MS-DOS, ma non vengono in alcun modo specificate le dimensioni 
dei dischi. L’MSX-DOS richiede un minimo di 64K di memoria RAM. 
L’unità centrale di elaborazione è uno Z80-A, o equivalente, funzionante 
a 3.58 MHz, affiancata da un processore per la periferica video Texas In- 
struments TMS 9129 (per l’Europa). Il VDP ha 16K di RAM dedicata al 
video e consente di definire fino a 32 sprite, ciascuno di un solo colore. 
Tutti gli sprite appaiono davanti al piano di visualizzazione dei caratteri. 
Il VDP genera inóltre l’unico segnale d’interruzione del sistema. Questo 
avviene al termine di ogni scansione del video (approssimativamente 1/50 
di secondo) e viene usato, per esempio, per l’analisi della tastiera. 

Lo Z-80 ha una capacità di indirizzamento sufficiente per accedere ad uno 
spazio di memoria di 64K bytes. All’accensione, la ROM di sistema occupa 
i 32K di memoria ad indirizzo più basso. Viene inoltre fornito un minimo 
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aggiuntivo di 8K RAM di memoria utente. In pratica, il metodo di gestio- 
ne della memoria comporta un’espansione di quest’ultima RAM aggiunti- 
va ad almeno 16K, ma quasi tutti i sistemi ne forniscono 32K o addirittura 
64K. 

L’interprete BASIC è in grado di utilizzare solo 32K di RAM - indipenden- 
temente da eventuali RAM aggiuntive sulle schede - dei quali 28K circa di- 
sponibili per la memorizzazione dei programmi. Il BASIC MSX è il BASIC 
Standard della Microsoft (versione 4.5) con alcune estensioni, soprattutto 
per le elaborazioni grafiche e musicali. 

Le principali caratteristiche comprendono un editor a schermo intero, co- 
mandi guidati da interruzioni e una precisione di 14 cifre sulle variabili del 
tipo di default. 

Le capacità di produzione di suoni sono fornite da un generatore di suoni 
programmabile (PSG) General Instruments AY-3-8910, che consente l’uti- 
lizzo di tre voci su un’estensione di tre ottave. Il PSG inoltre gestisce l’input 
da joystick; la specifica minima per lo standard MSX indica una sola por- 
ta standard per joystick di tipo D. 

Una PPI (Interfaccia periferica programmabile) 8255 Parallel I/O viene usata 
per selezionare i banchi di memoria che saranno visti dal processore in quat- 
tro “alloggiamenti”, o “partizioni”, di 16K (si veda oltre), e per la scansio- 
ne della tastiera. Se viene fornita una porta per stampante (un’estensione 
standardizzata) essa è ancora servita dall’8255. 

Una seconda estensione opzionale sottoposta a standard è un’interfaccia 
RS-232C. I componenti LSI necessari per quest’ultima sono il chip d’in- 
terfaccia di comunicazione 8251 e un temporizzatore ad intervallo program- 
mabile 8253. 

Al momento di andare in stampa i seguenti modelli sono stati annunciati 
per il mercato inglese: 



Hitachi MB-H80 

Toshiba HX-10 

Sony HB-75 (48K ROM) 

Sanyo M PC 100 
JVC HC-7GB 
Yashica YC-64 
Sega-Yeno DPH-64 
Goldstar FC-20 
Canon V-20 

Yamaha CX5M (sintetizzatore + computer MSX) 
Mitsubishi MLF-48 
Mitsubishi MLF-80 
Panasonic CF2800 
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Organizzazione delia memoria 



Lo Z-80 può leggere e scrivere dati da e in un’area di memoria fino a ses- 
santaquattro kilobyte. Il progetto MSX consente si scegliere questi 64K by- 
te in una memoria più ampia. Questo banco di memoria è composta da 
quattro “partizioni” principali, o slot, ciascuna delle quali può contenere 
fino a 64K. La selezione della memoria viene gestita in blocchi, o pagine, 
di 16K ciascuno. L’area di memoria indirizzabile dallo Z-80 consiste quindi 
in quattro di queste pagine da 16K. 

La porta A del PPI 8255 viene usata per determinare da quale delle sud- 
dette partizioni viene fornito ciascun blocco da 16K. I due bit meno signi- 
ficativi indicano quale tra esse fornisce il blocco da 0 a 16K e cosi via per 
i bit di ordine maggiore. 

Si noti che un blocco può essere visto dal processore solamente alla stessa 
locazione che esso occupa nella partizione principale, vale a dire, per esempio, 
che il blocco della quarta partizione che copre gli indirizzi da 48K a 64K 
può apparire al processore solo a questi indirizzi e non da 0 a 16 o da 32 
a 48K. 

Le partizioni principali sono numerate da 0 a 3. Nella partizione 0 trovano 
posto i 32K della ROM del sistema operativo e dell’interprete. La maggior 
parte degli elaboratori MSX è dotata di 64K di RAM. Quest’ultima è di 
solito posta in un’unica partizione. Per esempio, il Sanyo MPC-100 usa a 
questo scopo il numero 3 mentre il Toshiba HX-10 usa la partizione nume- 
ro 2. Una di quelle che restano è per la cartuccia nastro, mentre l’altra può 
essere configurata sia per un’altra cartuccia sia per una espansione del bus. 
La memorizzazione dei programmi BASIC inizia dall’indirizzo 32768. 



Porte di ingresso/uscita 

Oltre a poter indirizzare 64K di memoria, lo Z-80 può effettuare delle ope- 
razioni di ingresso e uscita su 256 porte di otto bit ciascuna. Le porte dalla 
128 alla 255 (&H80-&HFF) sono assegnate alle componenti del sistema e 
alle eventuali espansioni: RS-232C, stampante, processore del video, gene- 
ratore di suoni, penna luminosa, ecc. Le restanti sono riservate. Il NMI (In- 
terruzione non mascherabile) non è utilizzabile poiché il vettore locazione 
66H viene usato. nelI’MSX-DOS. 

Le operazioni di ingresso e uscita dovrebbero essere effettuate usando le 
procedure della ROM residente, poiché lo standard non garantisce che le 
locazioni di sistema siano le stesse sulle varie macchine. Un’eccezione può 
essere fatta per il processore video, dove può rivelarsi necessario un trasfe- 
rimento rapido di dati. 
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Fig. 1.1 - Mappa della memoria. 








Interfaccia nastro 



Lo standard MSX non richiede la presenza di un’unità nastro dedicata. La 
velocità di trasferimento di default è di 1200 baud (circa 1200 bit al secon- 
do) ma può essere elevata a 2400. La rilevazione e l’adeguamento ad una 
velocità differente da quella standard avviene automaticamente. La con- 
nessione esterna è una basetta DIN a 8 pin con la possibilità di controllo 
del motore del nastro. La modulazione avviene per mezzo di uno sposta- 
mento di frequenza sotto il controllo del software. I livelli ottimali per la 
registrazione e per la riproduzione vengono determinati dal registratore na- 
stro; spesso però è necessario un livello assai vicino al massimo. Il motore 
dell’unità nastro può essere controllato per mezzo dell’istruzione MOTOR 
del BASIC. 

Sono consentiti tre tipi di file: 

1. Programmi memorizzati su cassetta. I comandi relativi sono CLOAD, 
CSAVE e CLOAD? per verificare. 

2. File in formato ASCII, per i quali si usa SAVE e LOAD. Non è invece 
disponibile un comando per la verifica. I file di programma e i file ASCII 
possono essere mischiati. 

3. Immagini del contenuto della memoria, per le quali si usa BSAVE e 
BLOAD. Anche in questo caso non è disponibile un comando di verifica. 

Modalità di visualizzazione 

Il TMS 9129A è in grado di visualizzare un piano video con un massimo 
di 15 colori (più il trasparente) indipendentemente da qualsiasi sprite. 
Sono disponibili quattro modalità di visualizzazione, due per i testi e due 
per la grafica: 

1) Modalità testo con 40 * 24 caratteri, due colori e nessuno sprite, matri- 
ce di 6 * 8 punti per la visualizzazione del carattere, un insieme di 256 ca- 
ratteri disponibili. 

2) Modalità testo con 32 * 24 caratteri, 16 colori, matrice carattere di 8 * 8 
punti, insieme di 256 caratteri disponibili. 

3) Modalità grafica ad alta risoluzione con 32 * 24 caratteri e 16 colori. Si 
tratta essenzialmente di una modalità simile a quella per i testi, con 32 * 24 
caratteri e con un insieme di caratteri su 768 celle per permettere uno schermo 
“bit-mapped” - più l’informazione extra del colore. 

4) Modalità multicolore, 16 colori, ciascun blocco di 4 * 4 pixel può essere 
di diverso colore. Non sono disponibili i caratteri. 
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La modalità di visualizzazione viene selezionata usando l’istruzione BASIC 
’SCREEN’ oppure andando a modificare i tre bit che definiscono la mo- 
dalità in due degli otto registri a sola scrittura del VDP (M3, bit 6 del regi- 
stro 0, MI ed M2, bit 3 e 4 del registro 1). In tutte le modalità, tranne in 
quella per i testi a 40 colonne, il colore del bordo può essere definito indi- 
pendentemente. 

Il VDP scandisce i 16K della memoria RAM dedicata al video. Questa RAM 
è svincolata dallo spazio di memoria dello Z-80 e può essere letta o scritta 
dalla CPU solo attraverso il VDP. Quest’ultimo non fornisce alcuna fun- 
zione per lo scroll dello schermo. 

L’istruzione BASIC per pulire lo schermo (CLS) è in qualche modo inu- 
suale in quanto funziona in tutte le modalità di visualizzazione. 



II VDP e gli integrati per la produzione del suono 

Texas TMS 9129A VDP (Processore video) 

Si tratta di un integrato a 40 pin standard “dual in line” (D.I.L.I.P.) che 
usa 16K di RAM dinamica. Solo il VDP può accedere alla RAM dedicata 
al video usando un bus dati unidirezionale a 8 bit. Il VDP viene controlla- 
to usando tre linee: RAS, CAS e R/W che derivano dal bus indirizzi e dal- 
le linee di controllo del processore. Il VDP è inoltre connesso al bus dati 
di sistema. 

Per effettuare da BASIC un’operazione di lettura o di scrittura sulla RAM 
del video è necessario usare le istruzioni VPOKE e VPEEK oppure le ap- 
propriate procedure in ROM a livello di linguaggio Assembler. 



La struttura video del VDP 

In tutti i modi di funzionamento il VDP costruisce l’immagine da visualiz- 
zare principalmente a partire da due tabelle nella RAM video: 

1. La tabella generatrice dei modelli. 

2. La tabella dei nomi dei modelli. 

Nella tabella generatrice dei modelli sono contenute le definizioni di cia- 
scun carattere visualizzabile (cioè la descrizione, in termini di posizione dei 
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pixel, dei vari caratteri). L’indirizzo di partenza della tabella generatrice dei 
modelli in ognuna della modalità di visualizzazione è la seguente: 

Modalità 0: TEXT 40 : 2048 

Modalità 1: TEXT 32 : 0 

Modalità 2: HRG : 0 

Modalità 3: Multicolore : 0 



In tutte le modalità, tranne quella multicolore, ciascun carattere è definito 
nella tabella generatrice dei modelli per mezzo di otto byte con cui viene 
specificata la geometrìa dei pixel - tutti i caratteri standard sono inoltre 
giustificati a sinistra con le due colonne più a destra e la riga di base lascia- 
te vuote. 

Questo viene illustrato nella figura 1.3 

Nella modalità testo a 32 colonne possono essere usate fino a 256 defini- 
zioni di carattere, nel qual caso la tabella risulta lunga 2048 byte. La moda- 
lità HRG consente la definizione di 768 caratteri, producendo in tal modo 
una tabella lunga 6144 byte. La modalità testo a 40 colonne consente la 
definizione di 256 caratteri, ognuno di 8 byte, ma non vengono visualizza- 
te le due colonne più a destra di ciascun carattere. In questo modo è possi- 
bile ottenere una schermata di 40 colonne con della matrici di carattere di 
8*6 pixel e non di 8 * 8 come nella modalità HRG o testo a 32 colonne. 
Nella modalità multicolore la tabella generatrice dei modelli contiene 192 
entrate, ciascuna di otto byte, formate da quattro coppie di due byte cia- 
scuna. Ciascuna coppia non definisce il carattere bensì il colore delle celle 
4*4 nella matrice complessiva di 8 * 8. 

La struttura della tabella generatrice di modelli viene illustrata nella figura 
1.4. 

Esempio : Nella modalità testo a 32 colonne la tabella generatrice inizia al- 
l’indirizzo 0 della VRAM, quindi il carattere con codice 65 - una “A” - vie- 
ne definito dalle locazioni 65 * 8 = 520 fino alla 527. 

La tabella dei nomi dei modelli determina quale carattere compare in ogni 
posizione sullo schermo (nella modalità multicolore vengono determinati 
i colori). 

Nella modalità testo a 32 colonne ci sono 32 righe di 24 colonne e quindi 
32 * 24 = 768 posizioni. Ciascuna di queste può contenere uno dei 256 
possibili caratteri e di conseguenza la tabella dei nomi è lunga 768 byte - 
ognuno dei quali specifica quale carattere verrà messo in corrispondenza 
con una posizione. 

Nella modalità testo a 40 colonne la tavola dei nomi per lo schermo ha 
40 * 24 = 960 byte. Analogamente, ciascuno di questi descrive il carattere 
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TABELLA GENERATRICE TABELLA DEI NOMI 
DEI MODELLI DEI CARATTERI DEI MODELLI SCHERMO 




Fig. 1.3 - Mappa di visualizzazione di testi. 





VISUALIZZAZIONE SCHERMO 







Fig. 1,4 - Mappa delta modalità multicolore. 






visualizzato in una determinata posizione dello schermo. Così come nella 
modalità testo a 32 colonne, la scelta è ristretta ai 256 modelli contenuti 
nella tabella generatrice dei modelli. 



Grafica ad alta risoluzione 

Nella modalità HRG ci sono ancora una volta 768 posizioni nella tabella 
dei nomi, ma poiché in questa modalità sono disponibili 768 definizioni 
di carattere, come può un byte stabilire la selezione? 

A tale scopo lo schermo è concettualmente diviso in tre zone e le prime 
256 entrate nella tabella dei nomi selezionano i caratteri da 0 a 255, le se- 
conde 256 selezionano i caratteri da 256 a 511 e le ultime 256 i caratteri 
da 512 a 768. 

La tabella dei nomi nella modalità multicolore è lunga 768 bytes. 11 valore 
contenuto in ciascun byte è un riferimento a un blocco di otto byte nella 
tabella generatrice dei modelli per il multicolore. 

Due bytes di questo blocco indicano i colori dei blocchi 4*4 che formano 
la matrice del carattere. La colonna sullo schermo ove si trova la matrice 
carattere determina a quale dei quattro blocchi si fa riferimento. Se si trova 
sulla riga più alta vengono referenziati i primi due bytes, se si trova sulla 
seconda riga sono interessati i bytes 3 e 4 e così via, con la coppia successi- 
va usata per la riga successiva. Quindi le righe 0, 4, 8, 12, 16, 20 faranno 
tutte riferimento ai primi due bytes. 



Colore 

Benché il TMS 9129 VDP sia in grado di usare 15 colori più il trasparente 
(compresi il bianco e nero), nella modalità testo a 40 colonne possono es- 
sere usati solo due colori, e il bordo assume il colore dello sfondo. 

In ambiente BASIC questi sono impostati (come per le modalità) per mez- 
zo dell’istruzione COLOR, mentre in linguaggio macchina il registro a so- 
la scrittura numero 7 del VDP determina entrambi i suddetti colori. Per 
modificare quest’ultimo è preferibile usare la procedura appropriata con- 
tenuta nella RpM. 

Nella modalità testo a 32 colonne, la tabella generatrice dei modelli, con 
dimensioni 2K, è divisa in più insiemi di otto definizioni di carattere. Per 
ciascun insieme, il colore del primo piano e quello dello sfondo; sono de- 
terminati da un solo byte in una tabella generatrice di colori. Quindi la ta- 
bella dei colori è lunga 32 byte. 
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il colore dei primo piano è contenuto nel semi-byte più significativo e vice- 
versa per il colore dello sfondo. Ne consegue che per visualizzare una lette- 
ra due volte con differenti colori, la definizione del carattere deve essere 
duplicata in un’altra posizione della tabella generatrice dei modelli: a quel 
punto ad essa può essere assegnato un diverso colore. Nella modalità HRG 
la combinazione sfondo/primo piano può essere specificata per ciascuna 
delle otto “linee” di ciascuna matrice carattere. A questo scopo sono ne- 
cessari 768 * 8 = 6144 byte che vengono organizzati in un formato analo- 
go a quello della tabella generatrice dei modelli. Questo metodo di alloca- 
zione dei colori rende problematica un’eventuale procedura per lo scroll del 
video. 



Sprite 

Uno sprite è un blocco costituito da un quadrato il cui lato è di 1, 2 o 4 
celle carattere. È indipendente dal piano di visualizzazione e viene mosso 
facendo variare le coordinate X e Y che sono in relazione ad esso. Può es- 
sere acceso o spento come si desidera; inoltre ogni collisione tra due sprite 
viene rilevata automaticamente. Ogni sprite è dotato di una priorità e se 
una sezione non trasparente di uno sprite a più alta priorità passa davanti 
ad un altro, quest’ultimo viene parzialmente nascosto. Gli sprite consento- 
no di ottenere con facilità effetti piuttosto sofisticati come, ad esempio, si- 
mulazioni tridimensionali. 

Gli sprite non sono disponibili nella modalità testo a 40 colonne. In tutte 
le altre possono essere utilizzati sullo schermo fino a 32 sprite, con un mas- 
simo di quattro per ogni linea. Se si supera questo limite, solo i quattro 
sprite a più alta priorità vengono visualizzati sulla linea. Inoltre viene sol- 
levata la condizione di “quinto sprite” ed il suo numero viene posto nel 
registro di stato del VDP. 

Ciascuno sprite può essere di un unico colore e la sua priorità non può 
essere cambiata. II BASIC mette a disposizione dell’utente due istruzioni 
per controllare gli sprite. La prima, SPRITE$(n) viene usata per definire 
un banco di modelli di sprite e la seconda, PUT SPRITE determina la po- 
sizione, il colore e il numero di ogni sprite visualizzato. 

Questi comandi agiscono su due tabelle nella RAM video che contengono 
tutti i dati di visualizzazione degli sprite. La tabella dei modelli di sprite, 
che parte dalla locazione 14336 della VRAM (RAM Video) - indipenden- 
temente dalla modalità di visualizzazione - contiene la definizione della for- 
ma per tutti gli sprite. La tabella degli attributi degli sprite contiene le coor- 
dinate X e Y, il colore e il modello di ogni sprite. 

Gli sprite possono avere dimensioni sia di 8 * 8 pixel, sia di 16 * 16. Inoltre 
possono essere visualizzati con dimensione doppia di quella di definizione 
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- quindi si arriva ad un massimo di 32 * 32 pixel. Il loro posizionamento 
è relativo all’angolo sinistro in alto dello schermo e possono essere mossi 
di un pixel alla volta. 

La tabella dei modelli degli sprite può contenere fino a 256 blocchi di otto 
byte. Se gli sprite hanno dimensioni di 8 * 8 pixel (non si possono usare 
contemporaneamente quelli a 8 e a 16) allora possono essere definiti 256 
modelli di sprite differenti - il modello 0 dalla locazione 14336 alla 14343, 
il numero 1 dalla 14344 alla 14351 e così via. Se invece si scelgono gli sprite 
a 16 pixel, ciascuno di essi viene definito usando quattro blocchi consecu- 
tivi di otto byte. Ciascun blocco definisce una sezione pari a un quarto del- 
lo sprite, nella sequenza: 



1 3 

2 4 

Dopo la definizione della forma di uno sprite, esso viene posto sullo scher- 
mo tramite un’entrata della tabella degli attributi degli sprite. In tutti i mo- 
di di visualizzazione che consentono l’uso degli sprite, la tabella inizia al- 
la medesima locazione della VRAM: 6912 e ha una lunghezza massima di 
32 sprite * 4 byte = 128 byte. Ciascuna entrata serve ad indicare la posizio- 
ne, il colore e il numero di modello per un singolo sprite. I primi due byte 
danno le coordinate Y e X mentre il terzo identifica la forma selezionando 
uno o più blocchi nella tabella dei modelli degli sprite. L’ultimo byte con- 
tiene nel semibyte meno significativo il colore di sfondo dello sprite. In ag- 
giunta il bit più significativo consente di spostare a sinistra, quando è po- 
sto a 1, lo sprite di 32 pixel (“clock early bit”). 

Le collisioni tra sprite vengono gestite in BASIC usando le istruzioni SPRITE 
ON e ON SPRITE. 

La figura 1.2 mostra la combinazione dei vari piani di visualizzazione pro- 
dotti dal VDP. 



General Instruments AY-3-8910 PSG 
(Generatore programmabile di suoni) 

Si tratta di un generatore programmabile di suoni basato su registri che rende 
disponibili tre voci su un’estensione di otto ottave. Inoltre l’ingresso da joy- 
stick è gestito tramite due porte di I/O indipendenti, situate sulla scheda. 
Ogni voce ha un controllo separato di volume e può produrre un suono 
pulito oppure un rumore. Però la stessa frequenza di rumore e forma d’in- 
viluppo viene usata per tutti i canali - se due canali producono rumore, 
essi producono lo STESSO rumore; può essere regolato solo il volume. 
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Fig, 1,6 - Tabelle per gli sprite. 





Il PSG ha 16 registri interni di Iettura/scrittura, due dei quali hanno fun- 
zioni di registri di memorizzazione dati per le due porte del joystick. I re- 
stanti registri possono essere divisi in 5 gruppi; in base alla loro funzione: 

1. R0-R5: controllo della frequenza di canale. 

2. R6: frequenza del generatore di rumore. 

3. R7: registro di canale per la scelta tra rumore e suono pulito. 1 due bit 
più significativi determinano la direzione del trasferimento dati delle due 
porte di I/O. 

4. R10-R12 (Ottale): registri per la scelta tra ampiezza del suono controlla- 
ta dall’inviluppo e ampiezza del suono fissata. 

5. R13-R15 (Ottale): registri per la selezione della forma dell’inviluppo e 
del periodo. 

Le due porte di ingresso e uscita sono del tutto indipendenti dalle funzioni 
di generazione del suono del PGS. 

Il BASIC MSX comprende un buon numero di istruzioni per “fare musi- 
ca” per le quali molti parametri sono fissati per default. In combinazione 
con la capacità di generare interruzioni temporizzate, tutto quanto descrit- 
to permette di ottenere effetti musicali complessi con estrema facilità. 
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Capitolo 2 

IL BASIC MSX 



Descrizione. Variabili e funzioni. 

Comandi di grafica. Suoni. Memorizzazione dei programmi. 



Il BASIC MSX è sostanzialmente il BASIC Microsoft standard versio- 
ne 4.5 con numerose estensioni nell’area della grafica e della produzione 
di suoni. Le principali mancanze sono invece le Procedures, le strutture 
WHILE/WEND e REPEAT/UNTIL e la completa abbreviazione delle pa- 
role chiave. 

Viene reso disponibile un editor a schermo intero che permette di correg- 
gere una qualsiasi linea dello schermo. La correzione effettiva della linea 
avviene quando viene battuto il carattere RETURN mentre il cursore si trova 
su un qualsiasi carattere della linea in questione. Nella fase di introduzione 
non viene effettuato alcun controllo di correttezza. 

Una linea può essere composta al massimo da 255 caratteri e può contene- 
re più di una istruzione. 

Più istruzioni che si trovino sulla stessa linea devono essere separate dai 
due punti. Un’istruzione REM fa sì che l’esecuzione prosegua dalla linea 
successiva. I numeri di linea devono essere compresi nell’intervallo 0-65529, 
compresi gli estremi. 

Gli spazi non sono necessari e vengono ignorati dall’interprete (tranne quan- 
do fanno parte di una stringa). Una conseguenza di questo fatto è che le 
parole chiave non possono essere parte di nomi di variabili (dei quali sono 
riconosciuti solo i primi due caratteri). Vengono considerate diverse le let- 
tere maiuscole e quelle minuscole. La parole chiave possono essere scritte 
sia maiuscole che minuscole. 

A fianco della tastiera principale vi sono due gruppi di tasti. Sulla destra 
il gruppo dei tasti per l’editing - i tasti con le frecce che indicano la direzio- 
ne dello spostamento del cursore e le opzioni di inserimento e cancellazio- 
ne. Sulla sinistra c’è un insieme di cinque tasti funzionali. Al momento del- 
l’accensione questi tasti sono predefiniti con dieci funzioni. Quelle corri- 
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spondenti ai tasti funzionali “minuscoli” (cioè senza che sia premuto il ta- 
sto SHIFT) sono mostrate sull’ultima linea dello schermo. Questa visua- 
lizzazione può essere evitata, pur mantenendo la definizione delle funzio- 
ni, tramite il comando KEY OFF. 

Per ridefinire uno qualsiasi dei tasti funzionali, si usa l’istruzione KEYx, 
“stringa”. Per esempio, si può definire nel seguente modo il tasto funzio- 
nale 1 in modo che serva per mandare in esecuzione un programma: 

KEY1,"RUN” + CHR$(13) 



La visualizzazione di una lista di programma o un’esecuzione può essere 
interrotta premendo il tasto STOP una volta. Premendolo nuovamente vie- 
ne riattivata l’azione precedentemente interrotta. Per terminare definitiva- 
mente l’operazione in corso si devono premere contemporaneamente lo STOP 
e il tasto CONTROL. 

Per coloro che non hanno familiarità con il BASIC Microsoft è opportuno 
porre in evidenza una serie di caratteristiche: 

1. La messa a punto dei programmi è semplificata dall’uso delle istruzioni 
TRON e TROFF. Se viene eseguito il comando TRON, direttamente o al- 
l’interno di un programma, questo fa sì che venga visualizzato il numero 
di ogni linea che viene eseguita; solitamente eventuali altre visualizzazioni 
sono sovrascritte. 

2. Blocchi di linee possono essere cancellati con l’istruzione DELETE x, 
y, mentre le linee di un programma possono essere rinumerate tramite il 
comando RENUM x, y. Questa possibilità si rivela utile nell’identificare 
eventuali salti a numeri di linea non esistenti. In tal caso infatti il BASIC 
MSX non segnala un errore; viene invece eseguita la linea con numero im- 
mediatamente superiore a quello indicato nel salto. 

3. Tutte le variabili che iniziano con un particolare carattere, o con un in- 
sieme di caratteri, possono essere dichiarate di un particolare tipo: DEFINT 
per variabili intere, DEFSNG per variabili in singola precisione, DEFDBL 
in doppia precisione e DEFSTR per le stringhe. 

4. I vettori possono essere cancellati per mezzo del comando ERASE. 

5. Al momento dell’accensione lo spazio allocato per la memorizzazio- 
ne delle stringhe è di 200 byte. Un’ulteriore allocazione necessita dell’uso 
di un comando di CLEAR. Ad esempio, per riservare 1000 byte si usa 
CLEAR 1000. 

6. La funzione FRE(0) ritorna l’ammontare della memoria disponibile per 
la memorizzazione del programma. 




7. La funzione per le stringhe MID$ può essere usata per sostituire uno 
o più caratteri in un’espressione. 

8. La struttura GOSUB / RETURN consente di specificare un indirizzo 
di ritorno: RETURN “numero di linea”. 



Variabili e funzioni 

I nomi delle variabili possono essere di qualsiasi lunghezza, ma devono ini- 
ziare con una lettera. Solo i primi due caratteri sono significativi. Le lettere 
minuscole vengono distinte da quelle maiuscole. Non è necessario inizia- 
lizzare le variabili: viene assunto il valore zero. Le variabili di tipo vettore 
non devono necessariamente essere dimensionate, tranne quando il nume- 
ro di elementi supera undici: quindi S(0) e S(10), per esempio, non hanno 
bisogno di un esplicito dimensionamento. 

Una variabile che non è dichiarata di un tipo particolare si assume che sia 
reale in doppia precisione, e viene memorizzata con quattordici cifre signi- 
ficative. Le variabili dichiarate in singola precisione sono memorizzate con 
una massima precisione di sei cifre. Gli interi sono compresi tra —32768 
e 32767. 

Una variabile in singola precisione viene distinta tramite un punto escla- 
mativo alla fine, come SPI, mentre un’intera viene contraddistinta da un 
segno di percentuale (%). Se è necessario dichiarare una variabile in dop- 
pia precisione, viene usato il simbolo #. 

Come accennato in precedenza, le varianti dell’istruzione DEF possono es- 
sere utilizzate per definire globalmente i tipi delle variabili. Se ad esempio 
viene usata l’istruzione DEFINT A, allora tutte le variabili che iniziano con 
A verranno trattate come variabili intere. Inoltre non verrà fatta alcuna di- 
stinzione tra ‘A’ e ‘AW. 

II dimensionamento delle variabili è molto semplice: si consideri a questo 
proposito l’istruzione DIM X(20,40),Y(80,160) che definisce due matrici ret- 
tangolari; la prima ha 20 righe e 40 colonne mentre la seconda ne ha 80 
per 160. Esiste il limite di 255 sul numero delle dimensioni, ma il numero 
degli eleménti è limitato solamente dalla disponibilità della memoria. 
Poiché una qualsiasi variabile vettore che abbia meno di 11 elementi non 
deve essere esplicitamente dimensionata, ne consegue che, per un utilizzo 
ottimale dello spazio di memoria, è opportuno dimensionare quelle che han- 
no un numero di elementi minore di 11. 

Il BASIC MSX comprende un’istruzione SWAP x,y che serve per scambia- 
re il contenuto delle variabili x e y. Le variabili in questione devono però 
essere del medesimo tipo. Un’altra istruzione in relazione con le variabili 




è la VARPTR x che ritorna la locazione di memoria dell’oggetto specifica- 
to - se quest’ultimo è stato dichiarato. 

Le variabili di sistema dell’MSX sono: 

1. TIME: è, in un certo senso, l’orologio del sistema. Viene incrementato 
ogni 1/50 di secondo. 

2. BASE(n): ritorna la locazione della tabella specificata della RAM vi- 
deo, indipendentemente dalla modalità di visualizzazione. 

3. VDP(n): ritorna il valore del registro a sola scrittura specificato del VDP, 
0 viceversa il registro di stato di quest’ultimo. 

4. SPRITE$(patlern #): questa variabile viene usata per definire ognuna 
delle 256 possibili 8*8 forme di sprite, oppure una delle 64 forme 16 * 16. 
Contiene una stringa di 32 caratteri. Il codice di ciascuno di questi caratte- 
ri determina la configurazione dei bit in un byte della definizione dello sprite. 



Funzioni 



Sono disponibili tutte le funzioni che siamo abituati a trovare nel BASIC. 
In particolare, se XYZ è il nome di una variabile arbitraria: 



ASC(XYZ$), CHR$(XYZ), LEN(XYZ$), INT(XYZ), EXP(XYZ), ABS(XYZ), 
LOG(XYZ), HEX$(XYZ), OCT$(XYZ), BINS(XYZ), SGN(XYZ), RND(XYZ), 
MID$(XYZ$,N,n), RIGHT$(XYZ$,n), LEFT$(XYZ$,n), STR$(XYZ), VAL(XYZ$), 
STRI NG$(n ,XYZ$) , INSTR(XYZ$,xyz$), ATN(XYZ), COS(XYZ), SIN(XYZ), 
SQR(XYZ), TAN(X), TAB(n), SPC(n), INKEYS, INPUT$(n), PEEK(XYZ), 
POKEXYZ, FRE(O), FRE" USRXYZ(n), VARPTR(XYZ), VARPTR(#XYZ), 
C1NT(XYZ), POS(n) e LPOS(n). 



Le estensioni comprendono: 

1. CDBL(XYZ) e CSGN(XYZ) che convertono XYZ rispettivamente a dop- 
pia e singola precisione. 

2. VPEEK(n) e VPOKEn,x sono le istruzioni equivalenti, per la RAM vi- 
deo, di PEEK e POKE. 

3. STICK(n) e STRIG(n) ritornano la direzione o lo stato di trigger del joy- 
stick (oppure del cursore e della barra di spaziatura). 

4. POINT(x,y) ritorna il colore del pixel che si trova alle coordinate x e y. 

5. PLAY(canale) indica lo stato di una o di tutte le code musicali. 

6. EOF(file#) ritorna — 1 se è stata raggiunta la fine di un file sequenzia- 
le, altrimenti 0. 
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7. PAD(n): in questo caso n determina quale paramentro dello stato di un 
paddle a controllo tattile viene ritornato. 

8. PDL(paddle#) ritorna il valore di un paddle. 



Istruzioni per la grafica 

L’intera gamma dei 15 colori più il trasparente è disponibile in tutte le mo- 
dalità di visualizzazione (si veda l’Appendice B). Le istruzioni per la grafi- 
ca possono essere divise in tre categorie: 

1. Formattazione generale e colore. 

2. Sprite. 

3. Alta risoluzione. 

Comandi di uso generale 

La modalità di visualizzazione sullo schermo viene impostata con l’istru- 
zione SCREEN: 

SCREENO modalità testo 40 * 24 
SCREEN1 modalità testo 32 * 24 
SCREEN2 modalità grafica ad alta risoluzione (HRG) 

SCREEN3 modalità multicolore 

Questi comandi possono essere utilizzati anche per impostare la dimensio- 
ne degli sprite, la velocità di trasferimento dati su cassetta e le opzioni per 
la stampante. Quando vengono usate per selezionare una modalità testo, 
l’insieme dei caratteri viene copiato dalla ROM alla VRAM. L’istruzione 
SCREEN non deve essere usata qualora l’utente abbia la necessità di fare 
riferimento ad un qualsiasi carattere ridefinito. 

Modalità testo 

La larghezza effettiva dello schermo sia per la modalità a 40 colonne sia 
per quella a 32, può essere diminuita con l’istruzione WIDTH (ad esempio 
WIDTH20 per avere lo schermo su 20 colonne soltanto). Si noti che in en- 
trambe le modalità testo la colonna più a destra e quella più a sinistra non 
vengono usate. La maggior parte dei ricevitori TV non visualizzano la co- 
lonna più a sinistra. 

In entrambe le modalità i caratteri possono essere messi in una colonna 
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particolare scrivendo sulla tabella dei nomi della RAM video. Ad esempio, 
per mettere una A maiuscola nella prima riga della due colonne più a sini- 
stra nella modalità a 40 colonne, si usa la VPOKE delle locazioni 0 e 1 con 
il valore 65. 

I colori globali per una qualsiasi modalità di visualizzazione vengono im- 
postati tramite l’istruzione COLOR. Il formato della sua sintassi è il seguente: 

COLOR primo-piano, sfondo, bordo 

L’impostazione di default è 15, 4, 4. Nel modo a 40 colonne il colore del 
bordo non può essere specificato separatamente e assume quello dello sfon- 
do. Nei modi schermo 1, 2 e 3 si possono ottenere uno sfondo ed un bordo 
color grigio inchiostro con l’istruzione COLOR14,l,l. 

Si noti che nelle modalità grafiche il nuovo colore dello sfondo diventa ef- 
fettivo solo dopo un’istruzione CLS. 

Nella modalità testo a 40 colonne, il VDP non consente di usare altro colo- 
re. Non è possibile usare gli sprite. Viceversa nel modo a 32 colonne il VDP 
visualizza il testo in un colore differente da quelli scelti per mezzo dell’i- 
struzione COLOR. Però a questo scopo non esiste comando BASIC. Quindi 
per ottenere sullo schermo più di un colore di primo piano o di sfondo; 
è necessario apportare dei cambiamenti alla tabella dei colori della VRAM. 
Per far ciò si usa VPOKE. Un’operazione del tutto simile deve essere effet- 
tuata per ridefinire dei caratteri. 

In entrambe le modalità testo, la posizione del cursore viene determinata 
tramite l’istruzione LOCATE X,Y. Nel modo a 40 colonne è possibile vi- 
sualizzare fino a 37 caratteri su una linea. Nonostante siano accettate posi- 
zioni di colonna fino a 255, solo quelle comprese nell’intervallo 0-36 han- 
no effetto. Per la modalità a 32 colonne l’intervallo accettabile è da 0 a 28. 
Un’alternativa all’istruzione LOCATEO.O è la stampa su schermo di 
CHR$(11). Il comando LOCATE controlla inoltre la visualizzazione del cur- 
sore: 

LOCATE2,4,0 fa sì che esso non venga visualizzato 
LOCATE2,4,l abilita la visualizzazione del cursore 

II comando PRINT, che può essere abbreviato con “?”, usa i caratteri stan- 
dard per la formattazione: 

1. Il punto e virgola implica che il carattere di “ritorno carrello” (CR o 
carriage return, CHR$(13)) non venga stampato dopo l’ultima entità da vi- 
sualizzare. In questo modo la prossima visualizzazione non partirà dalla 
prima colonna della linea successiva. 
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2. Una virgola implica che la prossima entità visualizzata sia allineata con 
il prossimo carattere (o zona) di tabulazione presente sulla linea. Ogni zo- 
na di tabulazione è ampia 14 colonne. 

3. Il segno “ + ” serve per concatenare delle stringhe. Per esempio: 

A$ = B$ + “XYZ” 

TAB(n) e SPC(n) devono seguire l’istruzione di PRINT cioè 
PRINTSPC(4);“NOME 

Si noti che il delimitatore finale “ può essere assente. 

La variante PRINT US1NG consente di stampare tabelle numeriche o al- 
fanumeriche in un dato formato. I quattro principali caratteri di controllo 
sono: 

1. Il punto esclamativo (!): implica che venga stampato solo il primo carat- 
tere di una stringa, come: 

PRINT USING “NOME” darebbe come risultato N 

2. La barra (\): viene usata nella forma “\\” per specificare il numero dei 
caratteri della stringa che devono essere stampati. Il numero dei caratteri 
stampati è infatti due più il numero di spazi tra le due barre, come, ad 
esempio: 

PRINT USING “NOME” darebbe come risultato NOM 

Se la lunghezza del campo supera quella della stringa, vengono aggiunti 
degli spazi. 

3. II segno di ‘e‘ commerciale (&): viene usato per inserire una seconda stringa 
in una prima a partire dalla posizione in cui è posta la &; quindi: 

Q$ = “NOME”:?USING“IN &”;Q$ darebbe come risultato IN NOME 

Si noti che nel caso venissero fornite più sottostringhe, la sequenza mo- 
strata in precedenza verrebbe ripetuta per ciascuna di esse. Per esempio: 

Q$=“A”:Z$=“B”:?using“SU &”;Q$,Z$ darebbe come risultato SU ASU B 

4. Il segno di diesis (#): consente di stampare i numeri fissando il numero 
di cifre prima e dopo la virgola decimale. Se il valore è più corto, vengono 
aggiunti degli 0. Per esempio: 

?US1NG“ # # #. # #?’;2,4.684 darebbe 2.004.68 
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Se viceversa il campo è troppo corto per contenere il dato, allora viene stam- 
pato il segno % davanti al valore, oppure viene arrotondato. Per esempio: 

?USING“# #”;224444 darebbe come risultato <70224444 
?US1NG“# #.# #”;22.1234 darebbe 22.12 

Se il campo è troppo grande, il valore viene giustificato a destra o vengono 
aggiunti degli zeri. Per esempio: 

?USING“# #. # tf'\22.2 darebbe come risultato 22.20 
?USING“ # # # #”;22 darebbe 22 

11 numero non può essere più lungo di 24 cifre, nel qual caso verrebbe se- 
gnalata una situazione di errore. 

Altri caratteri di controllo per i numeri, usati insieme al segno “ sono: 
**, ££, la virgola, +, — e AA " (detto “carat”). 

Un segno più ( + ) alla destra o alla sinistra del simbolo diesis (#) implica 
che venga stampato il segno del valore numerico, rispettivamente alla de- 
stra o alla sinistra del valore stesso. 

In modo analogo, un segno negativo dopo l’ultjmo di una serie di 
provoca la stampa del segno meno dopo il valore, se questo è negativo. 
Quindi: 



?USING“ # — 2 stamperà 2 — 

La combinazione doppio asterisco (**) viene usata sulla sinistra dei sim- 
boli # e fa sì che gli spazi iniziali, che risultano da una giustificazione a 
destra di un valore, vengano riempiti con asterischi; quindi: 

?USING“** #. ?^’;4.2 dà come risultato **4.2 
?USING“** # #. #’;4.2 dà invece ***4.2 

Il segno di doppia lira (che qui indichiamo con ££) provoca la stampa del 
simbolo di lira prima del valore numerico in questione. Questo carattere 
di controllo non può essere usato in coincidenza del “carat” ( AAAA ). 

Se si pede una virgola alla sinistra del punto decimale, il numero viene stam- 
pato con una virgola a sinistra di ogni gruppo di tre cifre, vale a dire: 



?USING“ ####,. #’;2222.2 provoca la stampa di 2,222.2 

Infine il quadruplo carattere ( A ) viene usato per stampare un valore nume- 



24 




rico in forma esponenziale; come esempio si consideri: 

7USING “# #. # AAA *”;22.4 implica la stampa di 2.2E + 01 

Lo schermo può essere pulito in tutte le modalità di visualizzazione me- 
diante il comando CLS. In entrambe le modalità testo, un’alternativa è la 
stampa di CHR$(12). La coordinata Y del cursore viene ritornata dall’i- 
struzione CSRLIN e la coordinata X da POS(x) (dove x è un argomento 
fittizio, che può quindi essere sostituito da un qualsiasi valore). 

Manipolazione della RAM del video 

Per ottenere che i caratteri siano visualizzati con colori diversi da quelli 
impostati globalmente per mezzo del comando COLOR nella modalità te- 
sto a 32 colonne, si deve andare a modificare il byte appropriato nella ta- 
bella dei colori della VRAM, scegliendo una nuova combinazione primo 
piano/sfondo. 

Come già accennato, ciascun dei 32 byte della tabella dei colori determina 
i colori di un insieme di 8 dei 256 caratteri disponibili. Come conseguenza 
di ciò, per visualizzare del testo in colori diversi da quelli di default è ne- 
cessario copiare parte dell’insieme dei caratteri in un’altra sezione della ta- 
bella di generazione dei modelli. 



Tabella generatrice dei modelli : 0 -2047 

Tabella dei colori : 8192 - 8223 

Tabella degli attributi degli sprite : 6912 - 7039 

Tabella dei nomi : 6144 - 6911 

Tabella dei modelli degli sprite : 14336 - 16383 

Tavola 2.1 - Allocazione della memoria nella modalità testo a 32 colonne 



Si noti che i caratteri grafici occupano i primi 2 blocchi di definizione nel- 
la tabella dei modelli. Questo perché ì primi 32 codici carattere non sono 
stampabili. I caratteri grafici possono quindi essere visualizzati sullo schermo 
solo stampando (PRINT) CHR$(1) + CHR$(65). Un altro carattere non 
standard ha codice 255: provoca la visualizzazione inversa del carattere su 
cui è posizionato il cursore. Viene aggiornato circa ogni 1/50 di secondo. 
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Esempio: testo multicolore 

Per ottenere che un testo venga visualizzato in lettere maiuscole con primo 
piano giallo e sfondo nero, sono necessari i seguenti passi: 

Copiare le 26 definizioni dei caratteri in un’altra sezione della tabella di 
generazione dei modelli. L’insieme di caratteri viene definito usando 8 byte 
per ciascun carattere. I caratteri dal 65 al 90 seguono la sequenza indicata 
in Appendice B. 

Nella modalità testo a 32 colonne la tabella dei modelli si estende, nella 
VRAM, dalla locazione 0 fino alla 2048. Poiché ogni carattere necessita 
di otto byte di definizione, il primo byte che deve essere copiato si trova 
alla locazione: 

ASCf'A”) * 8 = 520 

e il byte finale della definizione dei caratteri sarà ASC(“Z’’)*8 + 7 = 727 
l ‘nuovi’ caratteri maiuscoli sovrascriveranno parte dell’insieme di caratteri 
esistenti. Sostituiremo i caratteri 145-170, che sono definiti da 145 * 8 = 1160 
a 170 * 8 + 7 = 1367, come segue: 

10 SCREEN 1:FOR X=0TO207:VPOKE 1160 + X,VPEEK(520 + X):NEXT 

I quattro byte della tabella dei colori che determinano i colori che assume- 
ranno i 32 caratteri dal 144 al 176 risiedono alle locazioni 8210-3. 11 valore 
contenuto dai quattro bit più significativi in ciascuno di questi determina 

11 colore del primo piano, mentre quelli meno significativi influiscono sul 
colore dello sfondo. 



PRIMO PIANO SFONDO 

Giallo: 10 Nero: 1 



= 10 * 16 + I =161 



Tavola 2.2 - Entrata della tabella del colore 



Quindi la prossima linea di programma è (si veda la tavola 2.2): 

20 FOR X=0 TO 3:VPOKE X + 8210,161:NEXT 

Se ora si prova a far visualizzare il CHR$(145) apparirà una ‘A’ gialla in 
campo nero. Si noti che se si usa il comando COLOR tutti i 32 byte della 
tabella del colore sarebbero impostati con i colori prescelti. Per ottenere 
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nuovamente dei colori alternativi sarebbe necessario ripetere la linea 20. 

I caratteri sono giustificati a sinistra: quindi quando vengono visualizzati 
su uno sfondo che contrasta con il colore dello schermo, può succedere che 
la parte sinistra del carattere appaia confusa. 

Questo metodo per determinare i colori dello schermo, sebbene macchino- 
so per certi aspetti, permette di realizzare delle schermate efficaci dal pun- 
to di vista grafico in modo piuttosto semplice. Per esempio, una schermata 
che consista principalmente di 4-8 caratteri può essere ‘animata’ o resa lam- 
peggiante manipolando solo due byte della tabella del colore. 

II programma che viene presentato di seguito consente di ridefinire intera- 
mente l’insieme dei caratteri, di salvarlo e caricarlo da nastro. 1 tasti di con- 
trollo del cursore sono usati per muoversi sulla matrice dei caratteri e la 
barra di spaziatura viene utilizzata per invertire il valore del particolare bit 
su cui si è posizionati. 



ESEMPIO DI PROGRAMMA PER LA DEFINIZIONE 

DELL’INSIEME DEI CARATTERI 

-jQ 'a*************************************************** 

20 '**** PROGRAMMA DI UTILITÀ PER LA DEFINIZIONE **** 

30 ’**** DELL'INSIEME DEI CARATTERI CON FUNZIONI **** 

40'**** DI SALVATAGGIO, CARICAMENTO E COPIA **** 

50 ***************************************************** 

60 ' 

70 'USATE IL CURSORE PER MUOVERVI NELLA MATRICE1 
DI DEFINIZIONE. 

80 'PER CAMBIARE IL VALORE DEL BIT PREMETE LA BARRA 
DI SPAZIATURA. 

90 'NOTATE CHE IL COMANDO SCREEN OPERA UN RESET 
SULLA RAM VIDEO. 

100 ' 

110 FOR X = 0TO1 2:READA$,B$:POKE38000! + X,VAL("&H“ + 
A$):POKE38200 ! + X, VAL(' '&H " + B$): N EXT 

120 DEFUSR = 38000 LDEFUSR2 = 38200! 

130 DATA 21 ,21 ,00,40,00,90,1 1,11 ,40,00,9C,00,01 ,01 ,00,00,08,08, 
CD,CD,59,5C,00,00,C9,C9 

140 ON KEY GOSUB 240,270,290,430:KEY(1) ON:KEY(2) ON:KEY(3) 
ON:KEY(4) ON 

150 ON STRIG GOSUB 400:STRIG(0) ON 

160 KEY OFF:COLOR14,1,1:SCREEN 1,0:CLS 

170 LOCATE2.1 :PRINT“F1 ..SAVE F3..CHANGE CHR$":LOCATE 
2,3:PRINT “F2..LOAD F4..COPY CHR$“ 
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1 80 FORX = 0TO7:VPOKE 14336 + X,VPEEK(224 + X):NEXT:PUT 
SPRITE 0,(144, 47), 8,0 

190 FOR X = 373TO375:VPOKEX,0:NEXT:VPOKE371,24:VPOKE 
372,24 

200 A$ = STRI NG$(8, 46): FORX = 0TO7:LOCATE16,X + 6:PRINTA$:NEXT 

210 GOSUB 290:X1 = 1 :Y1 = 1 

220 X2 = STICK(0):IF X2 = 0 THEN 220 

230 ON X2 GOTO 350,220,360,220,370,220,380 

240 Z = USR(2):LOCATE2,20:PRINT"RECORD THEN RETURN" 

250 A$ = INPUT$(1):IF ASC(A$)< > 13 THEN 250 ELSE BSAVE“CAS:", 
400001,42047! 

260 LOCATE 2,20:PRINTSTRING$(28,32):RETURN 
270 LOCATE 2,20:PRINT“LOADING...":BLOAD“CAS:“:Z = USR2(2) 
280 LOCATE 2,20:PRINTSTRING$(28,32):RETURN 
290 LOCATE 0,20:PRINT"ENTER # OF CHR$<RET>“:GOSUB 
470:CN = XX 

300 FOR X = 0TO7:A$(X) = BIN$(VPEEK(CN*8 + X)):NEXT 
310 FORX = 0TO7:IF LEN(A$(X))<8 THEN A$(X) = STRINGS 
(8 — LEN(A$(X)),79) + A$(X) 

320 FOR BT = 1T08:L0CATE15 + BT.X + 6:1 F MID$(A$(X),BT,1) = "1 " 
THEN PRINTCHR$(219) ELSE PRINTCHR$(46) 

330 N EXT: N EXT:LOCATE2, 1 1 :PRI NT* ‘CH ARACTER" ;CN : LOCATE7, 13: 
PRINT CHR$(CN) 

340 RETURN 

350 IF Y1 = 1 THEN 220 ELSE Y1 = Y1— 1 :GOTO390 
360 IF XI = 8 THEN 220 ELSE XI = XI + 1 :GOTO390 
370 IF Y1 = 8 THEN 220 ELSE Y1 = Y1 + 1 :GOTO390 
380 IF XI = 1 THEN 220 ELSE XI =X1— 1:GOTO390 
390 PUT SPRITE 0,(136 + XI *8,39 + Y1 *8),8,0:FORX = 1TO80:NEXT: 
GOTO220 

400 LOCATE 15 + XI ,5 + Y1 :IF MID$(A$(Y1 — 1 ),X1 , 1 ) = “1“THEN 
MIDS(A*(Y1 — 1 ),X1 ,1 ) = "0":PRINTCHR$(46) ELSE MID$(A$ 

(Y1 — 1 ,X1 ,1) = “1 ":PRINTCHR$(219) 

410 NN = CN*8 + Y1 — 1 :IF MID$(A$(Y1 — 1),X1 ,1) = “1 “THEN 

VPOKENN,VPEEK(NN)OR(2 A (8 — XI)) ELSE VPOKENN.VPEEK(NN) 
AND(255— (2 A (8— XI))) 

420 RETURN 

430 LOCATE0,20:PRINT"CHR$ TO COPY<RET > ":GOSUB470:C1 =XX 
440 LOCATE0,20:PRINT"CHRS TO BE REPLACED":GOSUB470:C2 = XX 
450 FORX = 0TO7:VPOKEC2*8 + X,VPEEK(C1 *8 + X):NEXT 
460 LOCATE0,20:PRINTSTRING$(28,32):RETURN 
470 Cl$ = "“ 
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480 X$ = INKEY$:IFX$ = ‘‘" THEN480 
490 IF ASC(X$) < 32 AND ASC(X$)>27 THEN 480 
500 IF ASC(X$) <>13 THEN C1$ = C1$ + X$:GOT0480 ELSE 
XX = VAL(C1$) 

510 IF XX >255 OR XX<0 THEN 470 

520 LOCATE0,20:PRINTSTRING$(28,32):RETURN 



Sprite 



Le istruzioni e le variabili fondamentali del BASIC per la manipolazione 
degli sprite sono: 

1. SPRITE$(numero modello) = XYZ$ 

2. PUT SPRITE n,(X t Y), colore, numero modello 

3. PUT SPRITE n,STEP(x,y), colore, numero modello 

4. SCREEN modo, dimensione sprite 

5. SPRITE ON/OFF/STOP 

6. ON SPRITE GOSUB 

La dimensione degli sprite può essere sia di 8 * 8 pixel sia di 16 * 16. Inoltre 
entrambe le suddette dimensioni possono essere raddoppiate. L’istruzione 
SCREEN determina la dimensione che verrà usata: 



0 = 8*8 

1 = 8*8 raddoppiato 

2 = 16*16 

3 = 16*16 raddoppiato 

quindi, ad esempio, SCREEN 2,2 provoca l’attivazione della modalità ad 
alta risoluzione grafica (HRG) con gli sprite di dimensione 16 * 16 pixel. 
Uno sprite di 8 * 8 pixels è definito, come un carattere, per mezzo di otto 
byte. Uno di dimensioni 16 * 16 viene definito usando quattro blocchi di 
otto byte: 



1 17 

I I 

8 24 

25 9 

I I 

32 16 

Questi ultimi sono definiti tramite l’istruzione SPRITES. Ciascuna defi- 
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nizione di modello di sprite viene introdotta in forma di stringa di 8 o di 
32 cai atteri, dove ogni numero corrispondente al carattere rappresenta un 
byte del modello. 

Per esempio, per definire uno sprite 8*8 che rappresenti il segno ’ — 

A$ = CHR$(0):B$ = CHR$(126) 

SPRITE$(0) = A$ + A$ + A$ + B$ + B$ + A$ + A$-;-A$ 

Infatti la configurazione dei bit che rappresentano 126 in numerazione bi- 
naria è la seguente: 

128 64 32 16 8 4 2 1 

111111 

In alternativa all’uso dell’istruzione SPRITES si potrebbe usare la VPOKE 
per scrivere i primi otto byte della tabella dei modelli per gli sprite: 

FORX= 14336 TO 14343:VPOKEX,0:NEXT:VPOKE14339,126: 

VPOKE1 4340,1 26 

Se sono attualmente in uso gli sprite 8 * 8 si possono definire fino a 256 
modelli di sprite, mentre con quelli a 16 * 16 pixel ne sono consentiti solo 
256/4 = 64. 

La possibilità di definire sprite di dimensioni così piccole facilita l’uso di 
un “insieme di caratteri” basato sugli sprite. È infatti possibile ottenere te- 
sto di dimensioni doppie e a più colori usando il suddetto insieme di carat- 
teri unitamente all’opzione di raddoppio delle dimensioni. Sebbene esista 
il limite di quattro lettere per ogni linea dello schermo, questo approccio 
evita i problemi associati con la giustificazione a sinistra dell’insieme di ca- 
ratteri residente nella RAM di sistema. 

Uno sprite può essere visualizzato sullo schermo e fatto muovere usando 
una delle due forme dell’istruzione PUT SPRITE. Lo schermo è indirizza- 
bile secondo coordinate che valgono 0,0 nell’angolo superiore sinistro, 0,190 
sull’angolo inferiore sinistro e 255,0 nell’angolo superiore destro. 

Una qualsiasi coppia di coordinate si riferisce al pixel in alto a sinistra del- 
lo sprite. Per poter far apparire lentamente lo sprite stesso entrambe le coor- 
dinate assumono come estremo inferiore — 32. In questo modo è possibile 
posizionare sprite “fuori” dello schermo. 

In ogni caso valori delle coordinate fuori dello schermo, ma comprese tra 
— 32768 e 32767 non provocano una situazione di errore. Infatti lo sprite 
verrà posizionato, in tal caso, secondo le coordinate che si ottengono dai 
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valori dati, dividendoli per 256 e considerando il resto della divisione intera. 
L’unica eccezione si ha quando la coordinata Y assume il valore 208. Infat- 
ti quando il VDP si trova in questa situazione provvede a togliere dallo scher- 
mo lo sprite in questione e tutti quelli di priorità inferiore. Si tratta di un 
metodo efficace per far lampeggiare gli sprite. Il formato standard delle 
istruzione PUT SPRITE è il seguente: 

PUT SPRITE piano, (X,Y), colore, numero del modello 

Il piano 0 è il piano a più alta priorità: ne consegue che ogni parte non 
trasparente di uno sprite che si trovi nel piano 0 si sovrapporrà a qualsiasi 
cosa vi sia sullo schermo nella medesima posizione. Il piano a priorità più 
bassa è il 31. Per ogni piano è consentito un solo sprite. 

Si ha inoltre a disposizione la stessa gamma di colori che si usa nell’istru- 
zione COLOR. Si noti che ogni sprite può essere di un solo colore. Se non 
lo si specifica, viene usato il colore corrente di primo piano. Se non vengo- 
no specificate le coordinate lo sprite viene posizionato alle coordinate 209,0. 
Un’eccezione a questo comportamento si ha nel caso in cui uno sprite sia 
stato posizionato in precedenza sul piano in questione: in questo caso si 
usano le precedenti coordinate. 

Ad esempio: PUT SPRITE0,(40,40),10,0:PUT SPR1TE0„10,2 provoca la 
sostituzione sul piano 0, in posizione 40,40, dello sprite modello 0 con quello 
modello 2. 

L’istruzione PUT SPRITE può assumere anche il seguente formato: 

PUT SPRITE Piano, STEP(x,y), colore, numero del modello 

che consente di variare le coordinate dello sprite in relazione a quelle correnti. 
Gli sprite hanno priorità maggiore rispetto al piano di visualizzazione dei 
caratteri: ogni parte non trasparente di uno sprite si sovrapporrà quindi 
alla schermata sottostante. Così come la limitazione di un solo colore per 
ciascuno sprite, anche questa priorità è intrinseca nel VDP. 

L’istruzione PUT SPRITE aggiorna un’entrata di quattro byte nella tabella 
degli attributi degli sprite, nella VRAM. In tutte le modalità che consento- 
no l’uso degli sprite, la suddetta tabella inizia all’indirizzo 6912 ed è lunga 
32 * 4 = 128 byte. I quattro byte di ciascuna entrata sono così allocati: 

Byte 1 Coordinata Y 

2 Coordinata X 

3 Numero del modello 

4 Colore/“Clock early bit” 
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In BASIC, la coordinata Y deve essere compresa tra — 32 e 209. Però, poi- 
ché un byte senza segno può assumere valori tra 0 e 255, nella tabella viene 
usata la notazione in complemento a 2 per le coordinate negative (trovere- 
te delle spiegazioni sulla notazione in complemento a due nella sezione che 
riguarda il linguaggio Assembly dello Z-80). 

Diverso è il caso della coordinata X che viene spostata di 32 pixel a sinistra 
nel caso sia stato impostato a 1 il “clock early bit”. 

Per esempio, per posizionare uno sprite blu sul piano 0 con numero di mo- 
dello 1 alle coordinate 100,100, le istruzioni che seguono costituiscono una 
alternativa all’uso di PUT SPRITE: 



VPOKE 6912,100:VPOKE 6913,100 
VPOKE 6914,1:VPOKE 6915,4 

Per spostare a sinistra lo sprite di 32 pixel si potrebbe usare sia: 

VPOKE 6913,68 
sia: VPOKE 6915,132. 

Con la seguente si possono togliere tutti gli sprite dallo schermo: 
VPOKE 6912,208 

Nel nostro prossimo esempio viene illustrato come copiare l’insieme dei ca- 
ratteri maiuscoli nell’area dei modelli degli sprite per ottenere un testo in 
formato non standard: 

10 SCREEN1,1:REM sprite espansi 8*8 

20 FOR X = 0 TO 207 

30 VPOKE 1 4856 + X,VPEEK(520 + X) 

40 NEXT 

I numeri di modello dal 65 in su sono stati usati deliberatamente allo sco- 
po di mantenere una corrispondenza numerica tra il numero del modello 
di sprite e il codice del carattere. Ciò permette infatti di visualizzare con 
facilità delle stringhe: 

10 A$ = "MSX":FOR X = 1 TO 3 

20 PUT SPRITE X,(18*X,40),1 1 ,ASC(MID$(A$,X,1)) 

30 NEXT 
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I due restanti comandi per la manipolazione degli sprite sono: 

1. ON SPRITE GOSUB 

2. SPRITE ON 



consentono di rilevare e gestire collisioni tra sprite. Una collisione si verifi- 
ca quando si sovrappongono parti non trasparenti di due sprite. 

Vi sono due limitazioni sull’informazione che è possibile dedurre da ogni 
collisione: 

1. Si possono rilevare solo collisioni sprite-sprite e non tra sprite e sfondo. 

2. Non è disponibile né una funzione BASIC né un registro del VDP che 
indichi quali sono i piani degli sprites coinvolti nella collisione. 

L’istruzione SPRITE ON attiva la procedura di controllo che quindi viene 
eseguita dopo ogni istruzione BASIC. Nessun controllo viene effettuato nella 
modalità ad esecuzione diretta del BASIC. Quando avviene una collisione, 
viene eseguita un’istruzione GOSUB alla routine che è stata specificata nel- 
l’istruzione ON SPRITE GOSUB. 

L’istruzione SPRITE OFF annulla ogni controllo riferito alle collisioni tra 
sprite. L’istruzione SPRITE STOP sospende l’effettiva attivazione della rou- 
tine di gestione della collisione, ma il controllo viene mantenuto attivo. In- 
fatti se avviene una collisione, essa viene ‘ricordata’ fino a quando viene 
eseguita un’istruzione di SPRITE ON nella chiamata della subroutine. 
Un’istruzione di SPRITE STOP viene automaticamente eseguita ogni vol- 
ta che si inizia l’esecuzione della routine di gestione delle collisioni. Analo- 
gamente quando si giunge al RETURN, viene eseguita una SPRITE ON - 
a meno che la routine stessa non contenga un’istruzione di SPRITE OFF. 
È importante ricordare che l’istruzione CLEAR effettua una SPRITE OFF. 
Accade spesso che il movimento degli sprite sia di natura fissata e ripetiti- 
va. Vale a dire che la loro posizione deve solo essere incrementata e decre- 
mentata ad intervalli di tempo prefissati. Il BASIC MSX comprende un 
potente insieme di comandi per far sì che, durante l’esecuzione di un pro- 
gramma, ad intervalli di tempo regolari, venga effettuato un salto ad una 
determinata routine. L’intervallo di tempo viene specificato in multipli di 
1/50 di secondo (cioè la frequenza tipica di interruzione del VDP). 

Il formato dei suddetti comandi è simili a quello dei comandi per la gestio- 
ne delle collisioni: 



1. INTERVAL ON 

2. ON INTERVAL = X GOSUB 
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Anche in questo caso esistono le varianti 1NTERVAL OFF e INTERVAL 
STOP; quest’ultima viene eseguita all’ingresso della routine di gestione. 
Se si specificano intervalli molto brevi, può verificarsi un leggero allunga- 
mento dell’intervallo effettivo a causa del controllo che viene effettuato dopo 
l’esecuzione di ogni istruzione BASIC. 

Due gruppi di comandi simili a quelli fin qui illustrati sono: 

1. ON STOP GOSUB e STOP ON/OFF/STOP 

2. ON KEY GOSUB linea x, linea y ... e KEY (x) ON/OFF/STOP 

La struttura ON STOP GOSUB / STOP ON va usata con una certa caute- 
la poiché può impedire il ritorno dalla modalità BASIC di esecuzione di 
un programma a quella di esecuzione diretta dei comandi. Per esempio: 

10 ON STOP GOSUB 40:STOP ON 
20 PRINT '‘NOSTOP":GOTO20 
40 RETURN 

è un programma che non può essere interrotto. Infatti quando si vuole che 
l’esecuzione di un programma non possa essere interrotta, è sufficiente che 
la linea 10 appaia dopo un’istruzione CLEAR. 



ESEMPIO DI PROGRAMMA PER DISEGNARE SPRITE 



Viene di seguito riportato un utile programma che vi permette di disegnare 
degli sprite a vostro piacimento. 

■j Q »************************************ 

20 ’**** DISEGNO DI SPRITE **** 

0Q ************************************* 

40 ’ 

50 'USARE IL CURSORE PER MUOVERSI NELLA MATRICE 
DI DEFINIZIONE. 

60 ’ 

70 'BARRA SPAZIATRICE PER ALTERARE IL VALORE DEL BIT 
ALLA SINISTRA DEL CURSORE. CTRL/STOP PER TERMINARE 
E PER STAMPARE I VALORI DEI BYTE. 

80 ’ 

90 KEYOFF:FORX = 0TO32:VPOKEX+ 14336, 0:NEXT 
100 ON STOP GOSUB300:STOP ON1 
110 SCREEN1 ,2:COLOR14,1 ,1 :CLS1 
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120 A$ = STRI NGS(1 6,CHR$(250)):FORX = 4T01 9:LOCATE 1 1 ,X: 
PRINTA$:NEXT 

130 X = 12:Y = 4:LOCATEX,Y,1:PUT SPRITE0,(20, 100), 14,0 
140 Q = 0:ON STRIG GOSUB 250:STRIG(0) ON 
150 FORL= 1 TO 60:NEXT:D = STICK(0):ON D GOTO 170,150,190, 
150,210,150,230 
160 GOTO 150 

170 IF Y< >4 THEN Y = Y — 1 :LOCATEX,Y,1 ELSE 150 
180 IF Y< >11 THEN 150 ELSE Q = Q — 1:GOTO 150 
190 IF X = 27 THEN 150 ELSE X = X + 1 :LOCATEX,Y,1 
200 IFX< >20 THEN 150 ELSE Q = Q + 2:GOTO 150 
210 IF Y= 19 THEN 150 ELSE Y = Y + 1:LOCATEX,Y,1 
220 IF Y< > 12 THEN 150 ELSE Q = Q+1:GOTO 150 
230 IF X= 12 THEN 150 ELSE X — X — 1 :LOCATEX,Y,1 
240 IF X< > 19 THEN 150 ELSE Q = Q — 2:GOTO 1 50 
250 IF VPEEK(61 45 + 32*Y + X) = 250 THEN VPOKE 6145 + 32*Y + X, 
219:AA = 2 ELSE VPOKE 6145 + 32* Y + X,250:AA = 4 
260 BY = 14336 + Q*8:IF Q = 0 OR Q = 2 THEN BY = BY + Y— 4 ELSE 
BY = BY + Y— 12 

270 IF Q = OOR Q=1 THEN Bl = 1 9 — X ELSE Bl = 27 — X 
280 VL = 2 A BI:IF AA = 2 THEN VPOKEBY,(VPEEK(BY) OR VL) ELSE 
VPOKEBY,(VPEEK(BY) AND (255— VL)) 

290 RETURN 

300 CLS: FORX = OTOl5:LOCATE2,X + 2:PRINTVPEEK(14336 + X): 
LOCATE8.X + 2:PRINTHEX$(VPEEK(14336 + X)):L0CATE1 2,X + 2: 
PRINTVPEEK(14352 + X):LOCATE18,X + 2:PRINTHEX$ 
(VPEEK(14352 + X)):NEXT 



Grafica ad alta risoluzione 

Il BASIC MSX ha sette istruzioni che possono essere utilizzate solo nelle 
due modalità grafiche: 

1) CIRCLE 2) DRAW 3) LINE 4) PAINT 
5) PSET 6) PRESET 7) POINT 

E ovvio però che queste istruzioni producono un risultato abbastanza sca- 
dente nella modalità multicolore dove la massima risoluzione è costituita 
da blocchi di 4 * 4 pixel. 

Non è possibile visualizzare caratteri sullo schermo grafico usando le nor- 
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mali istruzioni. Viceversa i caratteri possono essere visualizzati come dati 
da file: 

1. OPEN "GRP:“FOR OUTPUT AS#1 

2. PRESET (40,40) 

3. PR1NT#1 ."Testo grafico" 

Si noti che, a meno che si sia previsto un numero maggiore di file con l’i- 
struzione MAXFILES, il numero di file deve essere 1. Nella modalità mul- 
ticolore ogni lettera è approssimativamente di 2,5 cm quadrati. 

11 “cavallo di battaglia” delle istruzioni per la grafica è la DRAW nel se- 
guente formato: 

DRAW “comandi a lettera singola" 

I 13 comandi disponibili costituiscono quello che la Microsoft definisce un 
“micro linguaggio per la grafica”. Tramite essi si possono tracciare linee 
secondo una specifico passo a sinistra, a destra, in alto, in basso o in dia- 
gonale dal punto di riferimento corrente. Può essere utilizzato uno qual- 
siasi dei 16 colori disponibili. L’istruzione in questione è più comprensibile 
se si considera un esempio: 

DRAW "D40R40U40L40” 

Si ottiene un quadrato tracciando dapprima una linea di 40 unità di lun- 
ghezza verso il basso (D40), poi una verso destra (R40), poi una verso l’al- 
to (U40) ed infine verso sinistra (L40). I principali comandi per determina- 
re la direzione sono: 



U 

H E 

L + R 

G F 

D 

e “Cx” viene usata per impostare il colore. 

Per tracciare una linea fino ad una posizione specificandone le coordinate, 
si deve usare M X,Y. In alternativa per muoversi fino ad una posizione di 
cui siano note le coordinate relative al punto di riferimento corrente, è pos- 
sibile far precedere alla X e alla Y il segno “ + ” o il segno “ — 

L’unità di misura dei movimenti può essere impostata dal comando Sn do- 
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ve n è compreso nell’intervallo 0 - 255 (default = 4). Dividendo questo nu- 
mero per quattro si ottiene il numero dei pixel per ogni unità di spostamento. 
Se in un comando viene specificata una posizione sullo schermo, esterna 
all’intervallo — 32768 +32767, non viene segnalato alcun errore e viene as- 
sunta la posizione più esterna possibile. 

Esistono due varianti per ciascun comando di movimento: 

1. Usando come prefisso al comando una lettera ’B’ si provoca lo sposta- 
mento del cursore, senza che però venga tracciata alcuna linea. 

2. Usando come prefisso ’N’ si riporta il cursore grafico alla posizione ini- 
ziale, dopo il completamento dell’esecuzione del sottocomando. 

Le direzioni effettive possono essere ruotate in senso antiorario per multi- 
pli di 90 gradi con il comando An, dove n deve essere compreso tra 0 e 

3. come viene illustrato di seguito: 

0 

I 

1 + 3 

1 

2 

Quindi il comando DRAW “A3L40” serve per tracciare una linea verso de- 
stra per quaranta unità di spostamento. 

Il sottocomando X consente d’includere una variabile stringa nella linea 
di comando. 

La X precede il nome della variabile che viene seguito da un punto e virgo- 
la; per esempio: 

ST$ = “M— 20, + 40”;DRAW‘‘XST$;" 

Questo sottocomando non è però necessario qualora non si usino i delimi- 
tatori: DRAW ST$ . Inoltre anche una variabile numerica può essere usata 
in una linea di comando: è necessario farla precedere da un segno “ = ” 
e farla seguire da un DRAW “U=Y;”. 

Il formato del comando LINE è il seguente: 

LI NE(X1 ,Yl )— (X2,Y2),colore 

e provoca il tracciamento di una linea tra le due coordinate indicate; cia- 
scuna coordinata può essere specificata in modo alternativo usando la va- 
riante STEP dell’istruzione. 

Se il comando è fatto seguire da “,B” si ottiene il disegno di un rettangolo 
e se si usa “,BF” il rettangolo viene riempito 




Il comando CIRCLE consente di ottenere diagrammi piuttosto sofisticati 
in modo semplice. Una qualsiasi ellisse può essere specificata e disegnata, 
interamente o parzialmente. Il formato del comando di base è: 

CIRCLE (X.Y), raggio 

con le opzioni: 

colore, angolo di partenza, angolo finale, raggio apparente 

Le coordinate X e Y specificano il centro del cerchio; usando il formato 
STEP (X,Y) è possibile definire tale punto relativamente al riferimento cor- 
rente. Quando si usano l’angolo di partenza e quello finale devono assu- 
mere valori tra 0 e 2 pi greco. Viene accettato anche un valore negativo, 
ma provoca la visualizzazione di ulteriori linee tra il centro dell’ellisse ed 
il punto di partenza e di arrivo. Il raggio apparente è il rapporto tra i raggi 
orizzontale e verticale. 

Il comando PAINT è sufficientemente auto esplicativo; il suo formato è: 

PAINT (X.Y) oppure PAINT(X,Y), colore 

provoca il riempimento in colore di una qualsiasi figura che racchiuda le 
coordinate in questione. Se non viene specificato il colore, viene usato il 
colore corrente per il primo piano. Si noti che nella modalità HRG, il colo- 
re del bordo e quello specificato in PAINT devono essere i medesimi, altri- 
menti viene ricolorato l’intero schermo. Nella modalità multicolore si può 
usare la forma: 

PAINT(X,Y), colore di riempimento, colore del bordo. 

Esempio: Per produrre un cerchio rosso pieno, nella modalità HRG, usare: 

SCREEN2:COLOR8,1,1:CIRCLE(80,80),40:PAINT(80,80) 

I due restanti comandi: 

PSET(X,Y), colore 
PRESET(X.Y), colore 

sono identici nel senso che entrambi servono per indicare un colore per il 
pixel specificato. Tralasciando il parametro colore, PSET usa il colore di 
primo piano, mentre PRESET usa il colore di sfondo. 
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PROGRAMMA DI ESEMPIO “SKETCH PAD” 



Il seguente programma illustra l’uso della grafica ad alta risoluzione: 

Q '*********************************** 

20 ’**** SKETCH PAD **** 

»•**********■■*******•**★★******★******★ 

40 ’ 

50 'JOYSTICK NELLA PORTA 1. DISEGNARE SCHIACCIANDO 
IL PULSANTE DI ACCENSIONE 

60 ' 

70 'FI PER CAMBIARE COLORE; FAR SEGUIRE IL NUMERO 
DEL COLORE - DUE CARATTERI 

80 ’F2 PER TRACCIARE UN CERCHIO; FAR SEGUIRE DAL RAGGIO - 
DUE CARATTERI 

90 ’F3 PER RIEMPIRE UNA SAGOMA; DEVE ESSERE CHIUSA 
E DELLO STESSO COLORE USATO AL MOMENTO 
100 ’F4 PER SALVARE IL DISEGNO; DUE MINUTI PER IL 
COMPLETAMENTO DELL’OPERAZIONE. 

110 ’F5 PER CARICARE LO SCHERMO DA NASTRO; PREMI PLAY 
DOPO F5, DUE MINUTI PER CARICARLO. 

120 ' 

130 FOR X = 38000!T038024!:READA$:A = VAL(“&H“ + A$): 
POKEX,A:NEXT:DEFUSR = 38000! 

140 DATA21 ,00,00,1 1 ,40,9C,01 ,00, 18, CD, 59, 00, 21 ,00,20,1 1 ,40,B4, 

01 .00. 18, CD, 59, 00, C9 

150 FOR X = 38200 IT038224! .READ A$: A = VAL("&H‘' + A$):POKEX,A: 
NEXT:DEFUSR2 = 38200! 

160 DATA 21, 40, 9C, 11, 00, 00, 01. 00, 18, CD, 5C, 00, 21, 40, B4, 11, 00, 20, 

01 .00. 18,CD,5C,00,C9 

170 ON KEY GOSUB 350,360,370,380,410:KEY(1) ON:KEY(2) 
ON:KEY(3) ON:KEY(4) ON:KEY(5) ON 
180 ON STRIG GOSUB 180,240:STRIG(1) ON 
190 COLOR 10,1 ,10:SCREEN 2,0:CLS:X = 125:Y = 95 
200 FOR Z= 14336 TO 14343:READ ZZ:VPOKEZ,ZZ:NEXT:C = 10 
210 DATA 0,32,32,248,32,32,0,0,0 

220 PUT SPRITE0,(X — 2,Y — 4), 1 0,0: 1 F A = 1 THEN RETURN ELSE A= 1 
230 GOTO 230 * 

240 DN = STICK(1):IF DN = 0 THEN 240 

250 ON DN GOTO 260,270,280,290,300,310,320,330 

260 IF Y = 0 THEN 240 ELSE Y = Y- — 1:GOTO 340 

270 IF X = 255 OR Y = 0 THEN 240 ELSE X = X + 1 :Y = Y— 1 :GOTO 340 
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280 IF X = 255 THEN 240 ELSE X = X + 1 :GOTO 340 
290 IF X = 255 OR Y = 191 THEN 240 ELSE X = X+1:Y = Y+1: 
GOTO 340 

300 IF Y= 191 THEN 240 ELSE Y = Y.+ 1:GOTO 340 

310 IF X = 0 OR Y = 1 91 THEN 240 ELSE X = X— 1 :Y = Y + 1:GOTO 340 

320 IF X = 0 THEN 240 ELSE X = X— 1:GOTO 340 

330 IF Y = 0 OR X = 0 THEN 240 ELSE Y = Y— 1 :X = X— 1 

340 IF C< >0 THEN PSET(X,Y),C:GOTO 220 ELSE 220 

350 PUT SPRITE 2,(20,20),10,0:PUT SPRITE 4,(28,20), 10,0: 

A$ = INPUT$(1):PUT SPRITE 2,(0,0)„0:B$ = INPUT$(1):PUT 
SPRITE 4,(0,0)„0:C = VAL(A$ + B$):RETURN 
360 PUT SPRITE 2,(20,80),10,0:PUT SPRITE 4, (28, 80), 10,0: 

A$ = INPUT$(1):PUT SPRITE 2,(0,0)„0:B$ = INPUT$(1):PUT 
SPRITE 4,(0,0)„0:R = VAL(A$ + B$):CIRCLE(X,Y),R,C:RETURN 
370 PAINT (X,Y),C,C:RETURN 
380 Z=USR(2) 

390 SCREEN1 :CLS:LOCATE2,2:PRI NT' ‘PREMERE PLAY E RECORD 
QUINDI RETURN" 

400 A$ = INPUT$(1):IF ASC(A$)<>13 THEN 400 ELSE BSAVE 
1 ‘CAS:“ ,40000 ! ,52288 ! :STOP 

410 PUT SPRITE 2,(20,20),10,0:BLOAD''CAS:“:Z = USR2(2):PUT 
SPRITE 2,(0,0),,0:RETURN 

Generazione di suoni 



Per ottenere una semplice segnalazione sonora è sufficiente usare l’istru- 
zione BEEP o stampare CHR$(7). Suoni più complessi possono essere ge- 
nerati per mezzo dell’istruzione PLAY e del macro linguaggio ad essa col- 
legato o andando direttamente a modificare il contenuto dei registri del PSG 
con il comando SOUND. Quest’ultimo ha il seguente formato: 

SOUND numero di registro, valore 

Per conoscere in dettaglio le funzioni dei registri si consulti anche la sezio- 
ne dedicata all’AY-3-8910 

L’istruzione PLAY può essere seguita da un massimo di tre stringhe, cia- 
scuna della quali è una sequenza di comandi di una lettera che riguardano 
una ‘voce’ del PSG (il formato è simile a quello di DRAW). 

Per esempio, per suonare una singola nota con la voce numero 2, si deve 
usare la seguente istruzione: 

PLAY ‘'‘‘,“N20" 
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Poiché per molti parametri esiste un valore cl\e viene assunto per default, 
non è necessario procedere ad una lunga fase di inizializzazione. 
Esistono due metodi per indicare quale nota deve essere suonata: 

1. Nx dove x è compreso nell’intervallo tra 0 e 96. 0 provoca una pausa 
musicale. 

2. Impostando l’ottava tramite Ox (con x tra 1 e 8, 4 per default) e la nota 
con una lettera tra A e G (A = la, B = si, C = do, ecc., G = sol). Per esempio: 
PLAY“06ABCD“ farà suonare la scala la-si-do-re della sesta ottava. 

Se fosse seguita da: 

PLAY “BCD“ anche queste note verrebbero considerate della sesta ottava. 
Diesis e bemolli (solo quelli disponibili sul pianoforte) vengono prodotti 
usando # o + dopo la nota per i diesis, e — per i bemolli. 

11 volume di default è 4, in una scala da 0 a 15, e può essere impostato 
con il sottocomando Vx. 

La durata di ciascuna nota viene impostata usando il comando Lx dove 
x è compreso tra 1 e 64 (estremi inclusi). Il valore uno produce una nota 
della durata di una battuta musicale, il valore 4 una nota di un quarto e 
così via. Per ottenere una nota più lunga di 1 è necessario variare il tempo 
impostandolo con il comando Tx (default = 120). In quest’ultimo caso la 
x può assumere valori compresi tra 32 e 255 e determina il numero di note 
da un quarto che vengono suonate in un minuto. Per esempio, per fare in 
modo che tutte le note durino il doppio è necessario dare T60. 

Se è necessario cambiare solo la lunghezza di una singola nota, si può met- 
tere il reciproco della nota dopo la nota stessa, senza la “L”: ad esempio 
B#8o D32. 

Si noti che con tutti i comandi di una sola lettera, si possono usare delle 
variabili internamente al comando: 

PLAY “N=X;L=Y;N = X;“ 

Per semplificare la trascrizione la Microsoft ha reso possibile far seguire 
una nota da un punto per aumentarne la durata di metà. Un metodo alter- 
nativo a NO per ottenere una pausa consiste nell’uso del comando Rx dove 
x è compreso tra 1 e 64 e viene interpretato nello stesso modo del comando L. 
I due restanti sottocomandi di una sola lettera sono Mx e Sx: essi consen- 
tono di ottenere effetti sonori ancora più sofisticati modificando il timbro 
(l’inviluppo) del suono prodotto. Ogni forma d’onda inizia con una delle 
due seguenti sequenze: 

1. Il volume cresce da 0 fino al massimo. In questo caso il timbro ha un 
valore di ‘attacco’ pari a 4. 
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2. 11 volume decresce dal massimo fino a zero. Il timbro ha un valore di 
attacco di zero. 

Il resto della forma dell’inviluppo è determinato da altri tre parametri. Il 
valore di ciascuno di questi parametri viene aggiunto a quello iniziale di 
attacco. Il totale viene usato con il comando S in modo da determinare 
il timbro del suono nel modo scelto: 

1. Decadimento: se il suono deve terminare dopo il primo ciclo, questo pa- 
rametro vale 0, altrimenti viene impostato a 8. 

2. Tenuta: se impostato a 1, la sequenza di attacco viene ripetuta per ogni 
ciclo. Se impostato a 0, il volume viene mantenuto pari a quello che si ave- 
va alla fine del primo ciclo. 

3. Rilascio: il valore 2 fa sì che il volume sia modificato alla fine di ogni 
ciclo. Il valore 0 non provoca alcun cambiamento. 

Ognuno dei suddetti parametri può essere impostato in due modi, e quindi 
sono possibili 16 varianti nella scelta della forma dell’inviluppo e della sua 
interazione con il ciclo. Si tratta però di una duplicazione poiché in realtà 
esistono solo otto possibili modelli diversi. Questi ultimi vengono riporta- 
ti, insieme con i possibili valori dei parametri, nella quinta pagina dell’Ap- 
pendice E. I valori di default sono: 

Forma: 1 

Modulazione: 255 

Per esempio, per produrre note che mantengano il volume massimo rag- 
giunto per tutta la loro durata, è necessario dare ai parametri i seguenti valori: 

1. Attacco: 4 

2. Decadimento: 8 

3. Tenuta: 1 

4. Rilascio: 0 

Totale = 13 quindi PLAY“S13.... 

La durata del primo e dei cicli seguenti viene precisata con il comando M. 
Esso accetta valori interi compresi tra 1 e 65535 compreso. 

Un’ultima notazione a proposito del comando PLAY è che (come il co- 
mando DRAW) al suo interno possono essere usate stringhe predefinite, 
con il sottocomando X: 

A$= ,, N40N20N40":PLAY''XA$;" 

Se si usa una variabile essa deve essere seguita da un punto e virgola. Lo 
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stato di uno o di tutti i canali può essere ottenuto con il seguente formato 
dell’istruzione PLAY: 

PLAY (x) 

In questo caso x deve essere compreso tra 0 e 3. Se si controlla il canale 
1, o il 2, o il 3, viene ritornato il valore —1 se il canale stesso è attivo, zero 
altrimenti. Se invece si fa eseguire PLAY(O) viene ritornato — 1 se almeno 
uno dei tre canali è attivo, 0 altrimenti. 



Memorizzazione del programma 

In tutti gli elaboratori MSX con almeno 32K di RAM, la memorizzazione 
di un programma BASIC inizia dalla locazione 32768 (&H8000). Ogni li- 
nea di programma non viene memorizzata così come viene introdotta, ma 
in una forma condensata. La parole chiave sono sostituite con numeri sim- 
bolo (tokens) mentre i nomi delle variabili e i simboli vengono memorizza- 
ti direttamente. Inoltre ogni linea viene preceduta da due coppie di byte. 
La prima coppia contiene l’indirizzo della linea successiva mentre la se- 
conda contiene il numero della linea stessa. Le linee sono separate da un 
byte nullo (a zeri binari) e la fine del programma viene indicata con altri 
due byte con valore zero. 

Appena oltre il programma c’è una tabella per le variabili. In essa vengono 
memorizzate tutte le variabili non vettori del programma. Infine segue una 
tabella per i vettori. 

Per esempio, se viene introdotto il seguente programma: 

10 FOR X = 32768! TO 40000! 

20 PRINTX,PEEK(X) 

40 NEXT 



la sua memorizzazione è organizzata nel modo seguente: 



Locazione 


Valóre 


Commento 


32768 


0 




32769 


23 


Indirizzo della 


32770 


128 


riga successiva 


32771 


10 


Numero di riga 


32772 


0 
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32773 


130 


Sta per FOR 


32774 


32 


Codice di spazio 


32775 


88 


X 


32776 


239 


Sta per = 


32777 


29 


S.P. Costante 


32778 


69 


S.P.Byte dell’esponente 


32779 


50 




32780 


118 


S.P. Mantissa 


32781 


128 




32782 


32 


Codice di spazio 


32783 


217 


Sta per TO 


32784 


32 


Codice di spazio 


32785 


29 


S.P. Costante 


32786 


69 


S.P. Byte dell’esponente 


32787 


64 




32788 


0 


S.P. Mantissa 


32789 


0 




32790 


0 


Demarcatore di fine riga 


32791 


36 


Indirizzo della riga successiva 


32792 


128 




32793 


20 


Numero di riga 


32794 


0 




32795 


145 


Sta per PRINT 


32796 


88 


X 


32797 


44 


Virgola 


32798 


255 


Sta per PEEK 


32799 


151 




32800 


40 


( 


32801 


88 


X 


32802 


41 


) 


32803 


0 


Demarcatore di fine riga 


32804 


42 


Indirizzo della riga successiva 


32805 


128 




32806 


40 


Numero di riga 


32807 


0 




32808 


131 


Sta per NEXT 


32809 


0 


Demarcatore di fine riga 


32810 


0 


Demarcatore di fine programma 


32811 


0 





Notate come le costanti siano espresse in formato esteso. I parametri per 
il controllo del ciclo FOR..NEXT sono memorizzati in precisione semplice. 
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La tabella delle variabili semplici viene spostata quando si aggiungono o 
cancellano linee al programma. Le variabili sono memorizzate nell’ordine 
in cui esse appaiono nel programma. 11 primo byte di ciascuna ne indica 
il tipo: 

8. Doppia precisione. 

4. Precisione semplice. 

3. Stringa. 

2. Intero. 

I due byte che seguono sono i codici dei primi due caratteri del nome della 
variabile. La sezione restante è differente a seconda del tipo della variabile: 

1. Intero: il valore viene memorizzato in forma binaria rovesciata, con se- 
gno e su due byte. 

2. Stringa: tre byte vengono usati per memorizzare un dato di tipo stringa. 

II primo specifica il numero di caratteri della stringa. Gli altri due conten- 
gono l’indirizzo attuale della stringa vera e propria. Questo indirizzo ha 
il byte alto e quello basso invertiti. 

3. Precisione semplice: il valore viene rappresentato da un byte per l’espo- 
nente e da una mantissa a sei cifre, codificata in binario su tre byte. Il bit 
più significativo (m.s.b.) della mantissa indica, quando è a 1, che il valore 
è negativo. 

4. Doppia precisione: uguale al caso della precisione semplice, solo che per 
la mantissa vengono usati sette byte. 

Si noti che il byte dell’esponente, la cui locazione viene ritornata dalla fun- 
zione VARPTR, contiene un valore incrementato di &H40. 

Ciascuna entrata della successiva tabella dei vettori inizia nuovamente con 
tre byte che contengono il tipo della variabile e il nome. Però prima dei 
dati veri e propri c’è una testata. Quest’ultima ha tre sezioni: 

1. I primi due byte che contengono il numero dei byte restanti che com- 
pongono il vettore. 

2. Un singolo byte che contiene il numero di dimensioni. 

3. Una sequenza di valori su due byte che specificano l’ampiezza di ciascu- 
na dimensione. 
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Capitolo 3 

VOCABOLARIO 
DEL BASIC MSX 



ABS(Y) 

Funzione che ritorna il valore assoluto dell’espressione numerica Y. 
Esempio: ABS( — 4) ritorna 4. 

ASC(Y$) 

Ritorna il codice ASCII del primo carattere della stringa Y$. Se si tratta 
di un simbolo grafico, viene restituito 1. In caso di stringa nulla, viene se- 
gnalato un errore. Si faccia riferimento all’Appendice A per avere una lista 
completa dei codici dei caratteri. 

Esempio: ASC(“ABC“) ritorna 65. 

ATN(Y) 

Funzione che ritorna il valore dell’arcotangente dell’espressione Y. Il risul- 
tato è in radianti, compreso nell’intervallo tra — PI greca/2 e PI greca/2. 
Se Y è una variabile, può essere di un tipo qualsiasi: comunque il calcolo 
viene effettuato in doppia precisione. 

Esempio: C = ATN(40) ritorna 0.67474094222354 

AUTO ~ 

Varianti: AUTO 

AUTO numero di linea 

AUTO .incremento 

AUTO numero di linea, incremento 
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I valori di default sono: numero di linea 0 nel primo caso, incremento 10 
nel secondo e numero di linea 0 ed incremento 10 nel terzo caso. 

II successivo numero di linea viene visualizzato dopo ogni carattere di “Ri- 
torno carrello" (Carriage Return o <CR>). Le opzioni consentono di spe- 
cificare il numero di linea iniziale e l’incremento. La sequenza viene termi- 
nata con un CTRL-C o con un CTRL-STOP. Viene visualizzato un asteri- 
sco dopo ogni numero di linea che già esiste: in questo caso un ulteriore 
<CR> lascia inalterata la linea già esistente. 

Esempio: AUTO 200,20 dà ia sequenza 200, 220, 240.... 



BASE(Y) 

Si tratta di una speciale variabile in cui vengono ritornate le locazioni delle 
tabelle nella RAM video usate dal VDP per produrre l’attuale schermata. 
I valori di Y compresi tra 0 e 19 restituiscono la posizione di partenza di 
una singola tabella per una data modalità di visualizzazione. Per ulteriori 
dettagli vi consulti l’Appendice C. Ciascun modo ha una tabella dei nomi 
e una tabella per la generazione dei modelli. Queste ultime contengono i 
dati del piano di visualizzazione. 

Con l’eccezione della modalità testo a 40 colonne, i restanti modi hanno 
anche una tabella dei modelli degli sprite e una tabella per gli attributi de- 
gli sprite. La posizione di ciascuna di queste tabelle non cambia a seconda 
della modalità di visualizzazione: 

Tabella degli attributi degli sprite: 6912 
Tabella dei modelli degli sprite: 14336 

Esempio: BASE(0) ritorna 0, cioè la posizione di partenza della tabella dei 
nomi nella modalità testo. 

BEEP 

Genera un breve avvertimento sonoro. 

BINS(Y) 



Funzione che ritorna una stringa di caratteri “0“ e “1“ che costituiscono 
la rappresentazione binaria dell’espressione decimale Y. 

Y deve essere compreso nell’intervallo — 32768 e 65535. Un valore negati- 
vo viene espresso nella notazione in complemento a due. 

Esempio: BIN$(— 1) ritorna “1111111111111111“ 
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BLOAD 



Varianti: BLOAD“CAS:“ 

BLOAD“CAS:nome file“ 

BLOAD“CAS:“,R 
BLOAD“CAS:“, offset 

Carica un programma in codice macchina da cassetta (l’unico dispositivo 
previsto dalla versione 1 del BASIC), mettendolo in memoria alla locazio- 
ne dalla quale era stato salvato. 

L’opzione R esegue una chiamata, al termine del caricamento, alla locazio- 
ne che era stata specificata alla BSAVE (il programma viene eseguito). L’op- 
zione “offset 1 * consente di specificare uno spostamento deirindirizzo di ca- 
ricamento del programma rispetto a quello da cui era stato salvato. 
Esempio: BLOAD“CAS:“,R,&H20 provocherà il caricamento e l’esecuzio- 
ne del prossimo programma trovato sulla cassetta. Il programma verrà inoltre 
caricato 32 locazioni più in alto nella memoria rispetto alla posizione in 
cui era stato salvato. 

BSAVE‘'CAS:", inizio, fine 

Varianti: BSAVE“CAS:nome file 11 , inizio, fine 

BSAVE“CAS:“, inizio, fine, indirizzo di attivazione 

Si usa per salvare su cassetta l’immagine (cioè il contenuto corrente) di una 
porzione di memoria. È possibile specificare una locazione di attivazione 
qualora il programma sia poi caricato in memoria con una 
BLOAD“CAS:“,R. 

Se si usa BLOAD“CAS:“,R senza che sia stata precisata una locazione in 
fase di salvataggio, l’attivazione avviene dalla prima locazione occupata. 
Esempio: BSAVE“CAS:“, 34000, 38000,36000 salva il blocco di 4K byte tra 
34000 e 38000 (compresi). Se ora si carica il programma appena salvato 
con una BLOAD“CAS:“,R, allora, al termine del caricamento, viene atti- 
vato il programma a partire dalla locazione 36000. 

CALL istruzione * 

Varianti: CALL istruzione (argomento) 

CALL istruzione (argomento, argomento...) 

Nota: CALL può essere sostituito dal carattere di sottolineatura. 
L’istruzione CALL è usata per eseguire un comando reso disponibile da 
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una cartuccia ROM di estensione. 
Esempio: CALL SPSET(176,32) 



CDBL(Y) 

converte Y in un numero in doppia precisione. Y può essere di un qualsiasi 
tipo numerico. 



CHR$(Y) 

Viene ritornata una stringa di un solo carattere il cui codice ASCII è l’e- 
spressione Y. Per ottenere un simbolo grafico, è necessario prima eseguire 
CHR$(1). 

Esempio: CHR$(65) ritorna A. 

CINT(Y) 

Converte Y, troncandolo, in un numero intero. Viene segnalato un errore 
se Y non è compreso tra — 32768 e 32767. 

Esempio: Y=4.8:?CINT(Y) dà come risultato 4. 

CIRCLE (X,Y), raggio 

Varianti: CIRCLE(X,Y), raggio, colore 

CIRCLE(X,Y), raggio, colore, angolo partenza, angolo finale 
CIRCLE(X,Y), raggio,, angolo partenza 
CIRCLE(X,Y), raggio,,, angolo finale 
CIRCLE(X,Y), raggio, colore, a.p., a.f., raggio apparente 



Valori di default: 0 per l’angolo di partenza, 2*PI greco per quello finale. 
Il centro del cerchio, usualmente indicato in coordinate assolute, può an- 
che essere specificato relativamente ad una posizione di riferimento con l’op- 
zione STEP(X,Y). 

Se non viene specificato alcun colore, viene utilizzato quello corrente di 
primo piano. Se si usano le opzioni per l’angolo di partenza e per quello 
finale, i parametri devono essere in radianti, tra — 2*PI greco e 2*PI greco. 
Il raggio apparente determina il rapporto tra gli assi dell’ellisse. 
Esempio; CIRCLE(20,20),10,10,3.142,2 produce una mezza ellisse da PI greco 
a 2*PI greco. 
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CLEAR 

Varianti: CLEAR 

CLEAR spazio stringa 
CLEAR spazio stringa, memtop 

Default per il parametro memtop: &HF380 

Tutti i file aperti vengono chiusi, le variabili azzerate e le stringhe rese nulle. 
Il valore di default per lo spazio stringa è 200 byte. Con il parametro "mem- 
top” si indica la locazione di memoria più alta disponibile in BASIC. Il 
suo valore può venire abbassato qualora esista la necessità di allocare un 
codice macchina sull’area riservata al BASIC. In questo modo ci si assicu- 
ra che il codice non sarà sovrascritto dai dati del BASIC. 

Si noti che anche le istruzioni ON ... GOTO / GOSUB vengono annullate 
da questa istruzione. 

Esempio: CLEAR 400,44000 fa sì che lo spazio riservato per le variabili 
stringa sia di 400 byte e che il massimo indirizzo occupabile dal BASIC 
sia 44000. 

CLOAD 

Variante: CLOAD “nome file" 

Questa istruzione chiude tutti i file e azzera tutte le variabili prima di pro- 
cedere al caricamento del prossimo file di programma da cassetta. Se si in- 
dica il nome di un file, solo i primi sei caratteri sono significativi. 

CLOAD? 

Variante: CLOAD? “nome file" 

Il programma in memoria viene confrontato con il prossimo file di pro- 
gramma su cassetta (o quello indicato con “nome file”). Se vengono riscon- 
trate differenze viene segnalato “Verify error”. 

CLOSE 

Varianti: CLOSE 

CLOSE #Y 
CLOSE #Y, #Z 

Nota: il simbolo di diesis è opzionale. 

A meno che venga specificato il numero di un file, tutti i file vengono chiu- 
si e i buffer ad essi associati vengono rilasciati. Qualsiasi dato sia contenu- 
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to al momento dell’istruzione in un buffer di output viene prima visualiz- 
zato o stampato. 

Esempio: CLOSE 4 chiude e rilascia ogni buffer associato al canale 4. 
CLS 

Pulisce lo schermo, lasciandolo del colore dello sfondo specificato dall’i- 
struzione COLOR. Nella modalità testo, il cursore viene inoltre riportato 
nell’angolo a sinistra in alto. CLS è un’istruzione valida in tutte le modali- 
tà di visualizzazione. 

COLOR sfondo, primo piano, bordo 

Varianti: COLOR, sfondo 

COLOR, sfondo, bordo 

COLOR,, bordo 

COLOR primo piano,, bordo 

Quest’istruzione è valida in tutti i modi di visualizzazione. In entrambe le 
modalità testo, il colore di sfondo viene assunto immediatamente dopo la 
sua esecuzione. Nei modi ad alta risoluzione grafica e multicolore il cam- 
biamento viene reso effettivo da un CLS. Nella modalità testo a 40 colon- 
ne il bordo assume il colore dello sfondo. In tutte le modalità di visualizza- 
zione viene aggiornata l’intera tabella dei colori della VRAM. 

Esempio: COLOR 4,10,14 farà in modo che il bordo sia grigio (14), il piano 
di visualizzazione giallo scuro (10) e il primo piano (cioè “l’inchiostro” con 
cui vengono scritti i caratteri) blu scuro (4). 

CONT 

Fa riprendere l’esecuzione di un programma dopo uno stop. 

COS(Y) 

Ritorna il coseno dell’angolo specificato, in radianti, dall’espressione Y. 
CSAVE "nome file" 

Variante: CSAVE “nome file“, baud rate 

Il programma attualmente in memoria viene salvato su cassetta. Sono si- 
gnificativi solo i primi sei caratteri del nome del file. Il file può essere sal- 
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vato sia a 1200 baud (valore di default), sia a 2400: 

CSAVE "nome‘‘,1 .... 1200 baud 
CSAVE "nome' 1 , 2 .... 2400 baud 

CSGN(Y) 

Converte Y in un numero in singola precisione. 

CSRLIN 

Ritorna la posizione verticale del cursore sullo schermo, con valori da 0 a 23. 
Esempio: RIGA^CSRLIN 



DATA 

Serve per dichiarare una serie di dati che verranno acceduti dal program- 
ma con l’istruzione READ. Su una linea è possibile avere sia dati numerici 
sia dati di tipo stringa. I valori devono essere separati da una virgola. Non 
è necessario racchiudere le stringhe tra doppi apici, a meno che esse non 
contengano virgole, due punti, punti e virgola o spazi significativi. 
Esempio: DATAl.4,6,8.0,,,,4,2 

DEF FN Y(A) = Espressione 

Variante: DEF FN Y(A,B,C) = Espressione 

In questo modo viene definita una funzione i cui parametri sono di solito 
indicati tra parentesi. Dopo che sono stati valutati, i valori tra parentesi 
vengono sostituiti nell’espressione. Questa deve essere dello stesso tipo dei 
parametri della definizione. Nella definizione stessa sono consentiti fino 
a un massimo di otto parametri. 

Esempi: DEF FN Y(S) = 2 * S: T = 4: W = FN Y(T) implica che W assu- 
ma valore 8. 

DEF FN Y(S,A) = 2*S 4- (A + 4):T = 2:R = 4:N = FN Y(T,R) implica 
che N assuma valore 2*2 + (4 + 4)= 12 

DEFDBL Y 
DEFINT Y 
DEFSNG Y 
DEFSTR Y 
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Varianti: DEFINT W-Z 

DEFDBL A, B-S 

Ciascuna delle istruzioni in questione viene usata per dichiarare il tipo di 
ogni variabile (semplice o vettore) che inizia con una determinata lettera. 
Questa definizione globale può essere sovrascritta per una singola variabi- 
le da una successiva dichiarazione di tipo. 

Esempio: DEFINT A,B dichiara che tutte le variabili che iniziano con A 
o B saranno considerate di tipo intero. 

DEFUSRx = indirizzo 

Viene usata per indicare l’indirizzo di partenza di una routine in codice mac- 
china. Questa routine verrà attivata per mezzo dell’istruzione USR. L’inte- 
ro x deve essere compreso nell’intervallo tra 0 e 9. Se viene omesso viene 
assunto il valore 0. 

Esempio: DEFUSR2 = &H4000 

DELETE numero linea - numero linea 

Varianti: DELETE numero linea 
DELETE - numero linea 

Cancella tutte la linee tra le due specificate. Il numero di linea che viene 
cancellato deve comunque esistere. 

DIM Y(x) 

Varianti: DIM Y(x), Z(n) 

Se un vettore è composto da più di undici elementi, la presente istruzione 
serve per riservare dello spazio in memoria secondo le necessità. Un vetto- 
re di stringhe prevede l’allocazione di 255 byte per ciascun elemento. 
Esempio: DIM Y(20),S$(12) consente di usare gli elementi da Y(0) a Y(20) 
e da S$(0) a S$(12). 

DRAW "stringa di sottocomandi" 

Si tratta del principale comando per la grafica; esistono tredici possibili 
sottocomandi. Per avere spiegazioni più dettagliate si faccia riferimento al 
Capitolo 2. 

END 
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Termina l’esecuzione del programma e chiude tutti i file aperti. Non viene 
visualizzato alcun messaggio di “BREAK”. 

EOF(numero file) 

Funzione che viene usata per controllare se è finito un file da cui si leggo- 
no dati in ingresso in modo sequenziale. Il valore ritornato è 0 tranne nel 
caso in cui il file sia effettivamente finito (ritorna —1). 

Esempio: IF EOF(8) = — 1 THEN 200 

ERASE variabile di tipo vettore 
Variante: ERASE vettore, vettore, ... 

Cancella le variabili di tipo vettore il cui nome inizia con le lettere che ven- 
gono specificate. Per essere riusate, tali variabili devono essere nuovamente 
dimensionate. 

Esempio: ERASE X,Y cancellerà XC(16) e YJ(14) 

ERL 

Quando si verifica un errore, in ERL viene memorizzato il numero di linea 
nella quale si è verificato l’errore stesso. Se ciò accade in modalità di esecu- 
zione diretta, ERL contiene 65535. 

ERR 

Quando si verifica un errore, ERR ne contiene il codice corrispondente. 
ERRORx 

Istruzione che viene usata per forzare l’errore di cui viene specificato il co- 
dice. La x deve essere un intero compreso tra 1 e 255. Il BASIC usa codici 
di errore compresi tra 1 e 59: se vengono forzati provocano la stampa di 
messaggi esplicativi sul tipo di errore. Il messaggio “Unprintable error” (Er- 
rore non stampabile) viene prodotto nel caso in cui venga forzato un errore 
ed esso sia gestito dall’istruzione ON ERROR GOTO, ma non sia stata da- 
ta alcuna definizione per quel codice di errore. 

Esempio: 

10 ON ERROR GOTO 200 



100 ERROR 100 
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200 IF ERR = 100 THEN END 
EXP(Y) 

Viene ritornato il valore di “e” (la costante Neperiana) elevato alla Y. L’e- 
spressione Y deve assumere valori tra — 147.3654459516 e 145.06286085862. 

FIX(Y) 

Funzione che ritorna l’approssimazione intera dell’espressione Y. Essa dif- 
ferisce dalla INT per il trattamento delle espressioni negative. Infatti FIX 
tronca semplicemente il valore, mentre INT arrotonda, restituendo il valo- 
re intero più prossimo. 

Esempi: 

FIX(— 2.8) ritorna —2 
INT( — 2.8) ritorna — 3 

FOR Y=x1 TO x2 STEP x3 

Tutte le istruzioni che seguono la suddetta, fino alla NEXT appropriata, 
sono ripetute per tutti i valori di Y compresi tra xl e x2, considerati di vol- 
ta in volta con un incremento pari a x3. Se viene omessa l’opzione STEP 
x3, l’incremento viene assunto unitario. 

Se viene posto a zero il ciclo viene ripetuto indefinitivamente. Se x2 è mi- 
nore o uguale a xl e il passo è positivo, le istruzioni vengono eseguite una 
volta. 



FRE(““) 



Ritorna il numero dei byte restanti per la memorizzazione di stringhe. 
FRE(x) 

Funzione che ritorna il numero di byte disponibili per la memorizzazione . 
del programma. Poiché x è un argomento fittizio, esso può assumere un 
qualsiasi valore; inoltre non viene usato nella valutazione. 

Esempio: Z=FRE(2) 

GOSUB / RETURN 

Variante: RETURN numero di linea 
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Si tratta di una forma particolare dell’istruzione GOTO. Infatti quando viene 
incontrata l’istruzione RETURN, l’esecuzione riprende dalla linea succes- 
siva a quella in cui era l’istruzione GOSUB. 

GOTO numero linea 

Istruzione che trasferisce il controllo dell’esecuzione alla linea di cui viene 
indicato il numero (salto non condizionato). 

HEX$(Y) 

Funzione che ritorna l’equivalente in numerazione esadecimale dell’espres- 
sione intera Y. Questa deve essere nell’intervallo tra — 32768 e 65535. 
Esempio: HEX$(20) ritorna 14. 

IF condizione THEN 

Varianti: IF .. THEN .. ELSE .. 

IF .. THEN .. IF .. THEN .. ELSE .. 

IF .. GOTO 

IF .. GOTO .. ELSE .. 

Consente di eseguire un particolare gruppo di istruzioni solo se la condi- 
zione specificata è vera. Non è necessario usare GOTO per eseguire un sal- 
to dopo THEN e ELSE. Nella variante IF .. THEN .. IF .. THEN .. ELSE 
.. l’esecuzione prosegue con la linea seguente se la prima condizione non 
è soddisfatta. 

Esempio: 10 X=0:IF X = 1 THEN IF Y=2 THEN 40 ELSE 80 provocherà 
la continuazione dell’esecuzione dalla linea 20 (la successiva). 

INP(indirizzo di una porta) 

Un byte viene letto dalla porta specificata. 

INPUT Y 

Varianti: INPUT “stringa di avviso“;Y 
INPUT #numero di file, Y 
INPUT$(x) 

INPUT$(x, numero di file) , 

Quest’istruzione visualizza un punto di domanda per invitare l’utente al- 
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l’introduzione di un dato che verrà assegnato alla variabile indicata. 

Se questa variabile è stata dichiarata prima dell’istruzione INPUT, e l’u- 
tente non introduce alcun dato prima di premere il < CR > , il valore della 
stessa non viene modificato; in caso contrario viene posto uguale a 0. 
Le variabili possono essere semplici o vettori, sia di tipo stringa che nume- 
rico. Possono essere indicate più variabili separate da virgola. 

Esempio: INPUT “X,Y$ <ENTER>“;X,Y$ provocherà la visualizzazio- 
ne del messaggio: X,Y$ <ENTER>? di seguito al quale l’utente introdur- 
rà i valori richiesti. 

La seconda variante prevede invece la possibilità di indicare il numero di 
un file come sorgente di dati. Le varianti 3 e 4 ritornano entrambe una stringa 
di x caratteri - la terza prendendoli dalla tastiera, e la quarta dal file indi- 
cato. In entrambi i casi non è necessario terminare l’introduzione del dato 
con un <CR>. 

INKEYS 

Funzione che ritorna il primo carattere della coda associata alla tastiera; 
se questa è vuota viene ritornata una stringa nulla. 

Esempio: 10 A$ = INKEY£IF A$ = ““ THEN 10. 

Si noti'che lo stesso effetto di attesa del primo carattere battuto può essere 
ottenuto più efficientemente da A$ = INPUTS(1). 

INSTR(A$;B$) 

Variante: INSTR(x,A$,B$) 

Ritorna la posizione della stringa B$ all’interno della stringa A$. Se B$ 
è una stringa nulla oppure se non è contenuta in A$ viene ritornato il valo- 
re 0. La variante consente di effettuare la ricerca a partire da x caratteri 
dall’estrema sinistra di A$. 

Esempio: A = INSTR(2,“ABCD“,“D“) fa sì che A assuma valore 4. 
INT(Y) 

Ritorna il valore intero dell’espressione Y. Si veda, per confronto, anche 
l’istruzione FIX. 

Esempio: INT(4.8) ritorna 4. 

IN TER VAL ON /OFF/ STOP 

Istruzione che attiva, disattiva o sospende la chiamata di un sottoprogramma 
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ad intervalli di tempo specificati dalla ON INTERVAL. Per maggiori det- 
tagli si veda il capitolo due. 

KEY numero di tasto funzionale, “stringa" 

Associa la stringa data al tasto funzionale indicato. La stringa può essere 
lunga fino a un massimo di 15 caratteri. 

Esempio: KEY 2;*RUN“ + CHR$(13) 

KEY LIST 

Vengono listate, in ordine, le stringhe associate ai vari tasti funzionali. 
KEY ON7 OFF 

Provoca la visualizzazione (o viceversa la cancellazione) dei tasti funziona- 
li sulla ventiquattresima riga di testo dello schermo. 

KEY (numero tasto funzionale) ON / OFF / STOP 

Attiva, disattiva o sospende la chiamata a un sottoprogramma specificato 
dall’istruzione ON KEY GOSUB. Se viene attivata, il controllo che sia sta- 
to premuto il tasto funzionale in questione viene effettuato dopo l’esecu- 
zione di ogni istruzione BASIC. Per maggiori dettagli si veda il Capitolo 2. 

LEFT$(Y$,x) 

Ritorna gli x caratteri più a sinistra della stringa YS. Un carattere grafico 
occupa due posizioni. Se x è zero viene ritornata una stringa nulla. Se x 
è maggiore del numero di caratteri di YS, viene ritornata YS, senza che ad 
essa siano aggiunti degli spazi. 

Esempio: ?LEFT$(“NUOVA“,2) ritorna NU. 

LEN(Y$) 

Funzione che ritorna il numero di caratteri - compresi quelli grafici e di 
controllo - della stringa Y$. Un carattere grafico è composto da CHR$(1) 
e dal codice vero e proprio del carattere. 

LET variabile = espressione 

Istruzione che viene usata per assegnare il valore di un’espressione ad una 
variabile. Nota: opzionale nel BASIC MSX. 
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LINE (xl.yl) — (x2,y2) 



Varianti: LINE (xl,yl) — (x2,y2), colore 

LINE (xl,yl)— (x2,y2), colore, B 
LINE (xl,yl) — (x2,y2), colore, BF 
LINE — (x2,y2), colore 

Il formato STEP(X,Y) consente inoltre di sostituire ogni coordinata asso- 
luta con coordinate relative al punto iniziale di riferimento. 

Si tratta comunque di un’istruzione propria delle modalità grafiche per trac- 
ciare una linea tra i punti di cui vengono indicate le coordinate. L’opzione 
B disegna un rettangolo, mentre la BF disegna anch’essa un rettangolo ma 
lo riempie. Per maggiori dettagli si veda il Capitolo 2. 

LINE INPUT Y$ 

Variante: LINE INPUT “messaggio 11 ; Y$ 

Acquisisce un’intera linea da tastiera assegnandola alla variabile specifica- 
ta. Questa istruzione non può essere usata sia nella modalità HRG (grafica 
ad alta risoluzione) sia in quella multicolore. Il numero di caratteri intro- 
dotti non deve esere superiore a 254. L’assegnazione effettiva alla variabile 
avviene quando si preme il <CR>. 

LINE INPUT# numero del file, Y$ 

Assegna il contenuto di una linea, letta dal file sequenziale di cui viene in- 
dicato il numero, alla variabile stringa specificata. 

LIST 

Varianti: LIST numero di linea 
LIST numero di linea - 
LIST numero di linea - numero di linea 
LIST - numero di linea 
LIST . 

Comando per avere una lista di tutte o di parte delle istruzioni del pro- 
gramma residente in memoria. L’opzione può essere usata per: 

1. Listare nuovamente la linea precedentemente visualizzata. 

2. Listare la linea che ha provocato l’interruzione del programma in esecu- 
zione. 
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LLIST 



Varianti: le stesse di LIST. 

Quest’istruzione provoca la stampa effettiva su una stampante dell’intero 
programma corrente (o parte di esso). 

LOAD "nome file" 

Varianti: LOAD “riferimento al dispositivo“ 

LOAD “riferimento al dispositivo: nome file" 

LOAD “riferimento al dispositivo: nome file", R 

Il comando LOAD chiude tutti i file aperti e cancella il programma cor- 
rente dalla memoria, prima di caricarvi il file di programma, in formato 
ASCII, specificato. Se viene usata l’opzione R, i file non vengono chiusi 
e l’esecuzione riprende non appena è conclusa la fase di caricamento. Per 
una lista dettagliata dei riferimenti ai dispositivi si veda l’istruzione OPEN. 

LOCATE colonna, riga. 

Varianti: LOCATE .riga 

LOCATE „ modo del cursore 
LOCATE colonna, riga, modo del cursore 

L’istruzione LOCATE può essere usata solamente nelle modalità testo e spo- 
sta il cursore alla colonna e riga indicate. Nella modalità a 40 colonne i 
valori consentiti sono: 

Colonne: 0-36 

Righe: 0 - 22/23 (dipende dal modo del cursore) 

Nella modalità a 32 colonne: 

Colonne: 0-28 

Righe: 0 - 22/23 (dipende dal modo del cursore) 

Le colonne non utilizzabili possono essere accessibili solo scrivendo (con 
VPOKE) nella VRAM - si veda a questo proposito il Capitolo 2. Il modo 
del cursore può essere: 

0: il cursore non viene visualizzato 
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1: il cursore viene visualizzato 



LOG(Y) con Y > 0 

Funzione che ritorna il logaritmo naturale dell’espressione Y, che deve es- 
sere positiva. 

MAXFILES = Y 

Istruzione che serve per specificare il massimo numero di file che possono 
essere aperti contemporaneamente. L’espressione intera Y deve essere com- 
presa tra 0 e 15. L’uso di quest’istruzione è necessario qualora si voglia aprire 
più di un file alla volta. 

MERGE 

Varianti: MERGE “nome file" 

MERGE “riferimento al dispositivo" 

MERGE “riferimento al dispositivo, nome file" 

L’istruzione MERGE viene usata per unire e combinare il prossimo pro- 
gramma in formato ASCII presente su nastro con quello attualmente in 
memoria. Se i numeri di linea si sovrappongono, le linee iniziali vengono 
sostituite da quelle del secondo programma. 

Esempio: per caricare ed unire al programma attualmente in memoria il 
prossimo programma su cassetta usare: MERGE“CAS:“ 

M I D$(A$,x) = carattere 

Variante: MID$(A$,x,n)= n caratteri 

Istruzione che viene usata per sostituire I’x-esimo carattere di A$. Si ricor- 
di che tutti i caratteri grafici sono preceduti da CHR$(1). La variante con- 
sente di specificare la modifica di n caratteri. Se x è maggiore della lun- 
ghezza di A$ viene ritornata una stringa nulla. 

Esempio: A$ = “WAS“:MID$(A$,1,2) = “ I“:?A$ implica che venga visua- 
lizzato “ IS“. 

MOTOR 

Varianti: MOTOR ON (condizione di default) 

MOTOR OFF 
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Viene cambiato lo stato del motore dell’unità nastro per cassette. 
Esempio: Se il motore dell’unità è fermo, il comando MOTOR lo metterà 
in movimento, e viceversa. s 

NEW 

11 programma corrente viene cancellato dalla memoria e tutte le variabili 
vengono azzerate. 

OCT$(Y) 

Ritorna una stringa che rappresenta in numerazione ottale il valore dell’e- 
spressione decimale Y. 

ON Y GOTO x1,x2, ... xn / ON Y GOSUB x1,x2, ... xn 

Se Y= 1 viene effettuato un salto (GOTO) o una chiamata a sottoprogram- 
ma (GOSUB) al primo numero di linea indicato nella lista: xl. Se Y= 2 vie- 
ne considerato in modo analogo il secondo elemento x2 e così via. Se l’e- 
spressione Y vale 0 oppure è maggiore del numero di elementi della lista, 
l’esecuzione del programma prosegue dalla linea immediatamente successiva. 

ON ERROR GOTO x 

Se si verifica un errore viene effettuato un salto alla linea x. Se x vale 0, 
la gestione degli errori viene normalizzata. La routine di gestione degli er- 
rori (quella che inizia all’istruzione x) viene terminata da un’istruzione di 
RÉSUMÉ. 

ON INTERVAL = Y GOSUB X 

Per mezzo di quest’istruzione viene definito il sottoprogramma che verrà 
eseguito dopo ogni intervallo di tempo della lunghezza indicata (Y * 1/50 di 
secondo). Tale condizione deve essere attivata per mezzo di INTERVAL ON. 

ON KEY GOSUB x1,x2, ... xn 
*• 

Viene iniziata la chiamata a un sottoprogramma quando viene premuto un 
particolare tasto funzionale. Il primo numero di linea viene associato al 
tasto nmero 1, il secondo al numero 2 e così via. La chiamata avviene ef- 
fettivamente se l’associazione è stata resa attiva da un’istruzione KEY(x) ON. 
Esempio: ON KEY GOSUB 20,„40 implica che non sono stati definiti i 
sottoprogrammi associati ai testi funzionali 2 e 3. 
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ON SPRITE GOSUB Y 

Definisce il sottoprogramma che verrà attivato, qualora la condizione sia 
stata attivata da una SPRITE ON, alla collisione di due sprite. 

ON STOP GOSUB Y 

Definisce il sottoprogramma, che inizia alla linea Y, che verrà attivato quando 
verranno premuti simultaneamente il tasto STOP e quello di CTRL. L’a- 
zione viene effettivamente intrapresa se è stata preventivamente eseguita una 
STOP ON. 

ON STRIG GOSUB x 

Variante: ON STRIG GOSUB xl,x2,x3,x4 

Identifica il sottoprogramma che viene attivato, qualora sia stata eseguita 
una STRIG ON (Y), quando viene premuta la barra di spaziatura. 

La variante viene usata per consentire l’attivazione di diversi sottoprogrammi 
a seconda del segnale proveniente dai due joystick. Le linee di inizio dei 
sottoprogrammi devono essere fornite nel seguente ordine: 

1. Barra di spaziatura 

2. Segnale 1, Joystick 1 

3. Segnale 1, Joystick 2 

4. Segnale 2, Joystick 1 

5. Segnale 2, Joystick 2 

Esempio: STRIG (2) ON: ON STRIG GOSUB 200,400,600 implica che a 
fronte del segnale 1 del joystick 2 venga attivata la routine che inizia a li- 
nea 600. 

OPEN "riferimento al dispositivo": AS numero di file 

Varianti: OPEN “riferimento al dispositivomome file" 

AS numero di file 

OPEN “riferimento al dispositivomome file" 

FOR modo AS numero file 

Quest’istruzione apre un canale per un dispositivo e alloca un buffer di in- 
gresso/uscita. Un file deve essere aperto prima che sia eseguita un’istruzio- 
ne che faccia riferimento al numero di file ad esso associato. Per esempio 
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PRINT #, INPUT #, PUT o GET. Possono essere usati quattro riferimen- 
ti a dispositivi: 

1. CAS: cassetta 

2. LPT: stampante 

3. CRT: video 

4. GRP: schermo grafico 

Il numero associato ad un file viene usato da numerose istruzioni per la 
gestione dell’ingresso/uscita; deve essere compreso tra 0 e Y, ove Y è un 
intero specificato per mezzo dell’istruzione MAXFILES. 

La variante ’FOR modo’ serve a precisare il tipo di trasferimento dei dati: 

'INPUT’: file di ingresso sequenziale 
'OUTPUT’: file di uscita sequenziale 

’APPEND’: file sequenziale a cui vengono fatte delle aggiunte in coda. 
OUT numero della porta, byte dato 

Serve per mettere il byte di dato sulla porta d’uscita di cui viene indicato 
il numero. Sia il numero di porta che il byte di dato devono essere compresi 
tra 0 e 255. La configurazione standard MSX non prevede più di 256 porte 
di ingresso/uscita. 

PAD(Y) 

Ritorna lo stato di un particolare tipo di periferica che può essere connessa 
ad un elaboratore MSX, la tavoletta tattile. Y può assumere valori tra 0 e 7: 

0-3 per riferirsi alla tavoletta connessa alla porta 1. 

4 - 7 per riferirsi alla tavoletta connessa alla porta 2. 

Ciascuno dei quattro valori che possono essere scelti per ogni porta serve 
per avere lo stato di differenti parametri: 

0 e 4 ritornano — 1 se la tavoletta viene premuta, 0 se viene rilasciata. 

1 e 5 ritornano la coordinata X del punto in cui la tavoletta è stata premuta. 

2 e 6 ritornano la coordinata Y. 

3 e 7 ritornano — 1 se è premuto l’interruttore, 0 altrimenti. 

PAINT (X,Y) 

Varianti: PAINT STEP(X,Y) 

PAINT (X,Y), colore 

PAINT (X,Y), colore, colore della linea di bordo 
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Si tratta di un’istruzione che può essere usata sia nella modalità grafica ad 
alta risoluzione sia in quella multicolore. L’oggetto in cui è racchiusa la po- 
sizione specificata viene riempito con il colore dello sfondo. Si noti che nel 
modo HRG la linea del bordo deve essere sempre del colore di riempimen- 
to. Per maggiori dettagli si faccia riferimento al capitolo due. 



. PDL(Y) 

Ritorna lo stato di un paddle connesso sia al terminale A sia al terminale 
B. L’espressione Y deve essere un intero compreso nell’intervallo tra 1 e 12. 
Se il valore è dispari, le informazioni vengono lette dal terminale A, vice- 
versa dal B. Il valore ritornato è compreso tra 0 e 255. 

PEEK(Y) 

Ritorna il valore intero memorizzato all’indirizzo Y. L’espressione numeri- 
ca Y deve essere compresa tra — 32768 e 65535 (estremi compresi). 

PLAY "siringa sottocomando" 

Varianti: PLAY “stringa", “stringa", “stringa" 

PLAY “stringa, ““, “stringa" 

PLAY Y$,Z$,X$ 

PLAY “YS;stringa“ “stringa", “stringa" 

Si tratta della principale istruzione per la generazione di suoni. Ciascuna 
delle tre stringhe si riferisce a un canale di uscita audio. Per maggiori det- 
tagli si veda il Capitolo 2. 

PLAY(Y) 

Funzione che ritorna lo stato del canale (o dei canali) musicale specificato. 
Y deve assumere valori tra 0 e 3. Se nel buffer indicato vi sono dati, viene 
ritornato — 1. Se il canale non è attivo viene ritornato 0. PLAY(O) ritorna 
lo stato di tutti e tre i canali. 

POINT(XY) 

Ritorna il codice di colore del pixel di cui vengono indicate le coordinate. 
Quest’istruzione ha effetto solo nelle due modalità grafiche. Vien ritorna- 
to — 1 se una delle coordinate è esterna all’intervallo di validità. 
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POKE X,Y 

Scrive il valore di Y all’indirizzo X. Y deve assumere valori tra 0 e 255. 
L’intervallo di validità per l’indirizzamento è da — 32768 a 65535. Un indi- 
rizzo negativo viene prima sommato a 65535. 

Esempio: POKE 40000,254 scrive 254 all’indirizzo 40000. 



POS(Y) 

Ritorna la posizione orizzontale del cursore in entrambe le modalità testo. 
Y è un argomento fittizio che non viene usato nella valutazione. 

PRESET(XY) 

Varianti: PRESET (X,Y), colore 
PRESET STEP(X,Y) 



Il pixel dello schermo grafico di cui sono indicate le coordinate viene colo- 
rato con il colore dello sfondo. Le varianti consentono di specificare un 
colore diverso o d’indicare le coordinate relative ad un punto di riferimen- 
to prefissato. 

PRINT 

Varianti: PRINT “stringa" 

PRINT “stringa"; 

PRINT A$ 

PRINT Y 
PRINT ,X$ 

PRINT CHR$(Y)+A$ 

Nota: PRINT può essere sostituito da 

Se la parola chiave non è seguita da alcuna espressione, viene stampata (vi- 
sualizzata) una linea bianca. In ogni modo la stampa dell’ultima entità che 
segue PRINT viene sempre seguita da un <CR>, a meno che non sia a 
sua volta seguita, nell’istruzione, da un punto e virgola o da una virgola. 
Un punto e virgola provoca che l’entità venga stampata immediatamente 
dopo l’ultima visualizzata in precedenza, mentre la virgola fa sì che la stampa 
inizi dalla zona di tabulazione più prossima. Le zone di tabulazione sono 
ampie 14 caratteri. I caratteri di controllo possono essere usati per mezzo 
della funzione CHR$(Y). 
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PRINT # numero file, espressione 

Vale quanto detto per PRINT, tranne che l’output avviene verso il canale 
indicato. Un <CR> <LF> (CHR$(13),CHR$(10)) vengono fatti seguire 
aH’ultima entità della lista di output. 

PRINT USING 

Variante: PRINT # numero file, USING 

Consente di stampare indicando esplicitamente il formato per mezzo di ca- 
ratteri di controllo. Per maggiori dettagli si veda il Capitolo 2. 

PSET (X.Y), colore 

Variante: PSET STEP (X,Y), colore 

Il pixel indicato viene colorato, sullo schermo grafico, nel modo voluto. 

PUT SPRITE numero del piano di visualizzazione 

Varianti: PUT SPRITE numero piano, (X,Y) 

PUT SPRITE numero piano, STEP(x,y) 

PUT SPRITE numero piano, (X,Y), colore 

PUT SPRITE numero piano, (X,Y), colore, numero del modello 

Si tratta del principale comando per la gestione degli sprite. 

Con PUT SPRITE è possibile determinare la posizione, il colore e il mo- 
dello per uno sprite. Il cursore di sprite viene posizionato sull’angolo dello 
sprite in alto a sinistra. 

Un solo sprite può essere messo su ogni piano, ma un numero qualsiasi 
di sprite può assumere lo stesso modello. Per maggiori dettagli si veda il 
Capitolo 2 e l’istruzione SPRITES. 

Esempio: PUT SPRITE 0,(40, 40), 4, 2 

READ Y 

Variante: READ Y,X,Z.. 

L’istruzione READ viene usata per assegnare le costanti di un’istruzione 
DATA alle variabili che vengono specificate. Il dato letto deve essere di ti- 
po compatibile con la variabile a cui viene asssegnato. 
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REM 



Istruzione usata per introdurre dei commenti e delle note in un program- 
ma. Ogni successiva istruzione sulla stessa linea logica viene ignorata al 
momento dell’esecuzione, che invece prosegue da quella successiva. REM 
può essere sostituito da un singolo apice (’). 

RENUM 

Varianti: RENUM nuovo numero 

RENUM nuovo numero, vecchio numero 
RENUM nuovo numero, vecchio numero, incremento 
RENUM vecchio numero di linea 

Valori di default per il nuovo numero e per l’incremento: 10 
Tutte le linee del programma vengono rinumerate, compresi i riferimenti 
che seguono le istruzioni GOTO, GOSUB, THEN, ELSE, ON .. GOSUB, 
IF THEN e ERL. 

Il programma risultante inizia da linea 10 o, se viene indicato, dal nuovo 
numero. La variante con l’indicazione del “vecchio numero” fa sì che solo 
parte del programma, dal vecchio numero in avanti, venga effettivamente 
rinumerata. 

RESTORE 

Variante: RESTORE numero di linea 

Istruzione che fa in modo che il prossimo dato letto sia il primo della pri- 
ma linea di istruzione DATA. Con la variante è possibile specificare una 
linea di istruzione DATA diversa da quella iniziale. 

Esempio: RESTORE 200 farà in modo che la prossima istruzione di READ 
acceda all’istruzione DATA in linea 200. 

RÉSUMÉ 

Varianti: RÉSUMÉ NEXT 

RESUMlE numero linea 

L’istruzione RÉSUMÉ viene usata per terminare un sottoprogramma di ge- 
stione di un errore che sia stato attivato per mezzo di un’istruzione ON ER- 
ROR GOTO. Il suo effetto è quello di far continuare l’esecuzione del pro- 
gramma a partire dalla linea in cui si era verificato l’errore. La variante RE- 
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SUME NEXT è simile, tranne che l’esecuzione prosegue dalla linea succes- 
siva a quella che ha dato luogo alla situazione di errore. 

RIGHT$(A$,x) 

Funzione che ritorna una sottostringa di A$ contenente i suoi x caratteri 
più a destra. 

Se x è più grande del numero di caratteri di A$, viene ritornato A$. Se x = 0, 
viene ritornata una stringa nulla. Un carattere grafico comprende sempre 
un prefisso di CHR$(1). 

Esempio: RIGHT$(“SINISTRA“,20) ritornerà SINISTRA. 

RND(Y) 

Ritorna un numero casuale compreso tra 0 e 1, estremi esclusi. 

Se Y > 0 viene generato il prossimo numero casuale secondo la sequenza 
interna alla funzione stessa. 

Se Y = 0 viene restituito l’ultimo numero già generato. 

Se Y < 0 il generatore di numeri casuali viene rinizializzato con Y come 
radice. 

Si noti che la sequenza di numeri casuali prodotta da RND( — 2) è la stessa 
prodotta da ogni successiva attivazione RND( — 2). Per produrre una se- 
quenza ‘nuova’ vi consigliamo di usare RND(— TIME). 

RUN numero di linea 

Esegue il programma BASIC attualmente in memoria a cominciare dalla 
linea di cui è indicato il numero. Se quest’ultimo non compare, l’esecuzio- 
ne ha inizio dalla prima linea del programma. 

SAVE “nome file" 

Varianti: SAVE “riferimento al dispositivo:" 

SAVE “riferimento al dispositivo:nome file" 

Trasferisce un programma BASIC in formato ASCII sul dispositivo e/o sul 
file che vengono indicati. La fine del file viene codificata come CTRL-Z. 
Si noti che non è possibile verificare un file. La velocità di trasferimento 
viene specificata per mezzo dell’istruzione SCREEN. 

Esempio: SAVE “CAS:PROG4“ 

SCREEN modo, dimensione degli sprite selettore di “keyclick”, baud rate 
della cassetta, opzione stampante 
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L’istruzione SCREEN viene usata per selezionare sei opzioni nel modo se- 
guente: 

Modo: 0 Modalità testo 40 * 24 

1 Modalità testo 32 * 24 

2 Modalità ad alta risoluzione 

3 Modalità multicolore 

Dimensione degli sprìte: 

0 8*8 pixel 

1 8*8 pixel ingranditi 

2 16 * 16 pixel 

3 16 * 16 pixel ingranditi 

Selettore di “key click”: 

0 “keyclick” attivo (premendo un qualsiasi tasto sulla tasiera 
si sente un leggero “click”) 

1 “keyclick” disattivato 

Baud rate della cassetta: 

1 velocità di trasferimento dati pari a 1200 baud 

2 2400 baud 

valida sia per il formato dei programmi sia per il formato ASCII. 

Opzione stampante: 

0 Stampante MSX 

<0> Assenza delle facilitazioni grafiche dell’ MSX 

Se viene selezionata l’ultima opzione, tutti i simboli grafici vengono sosti- 
tuiti con degli spazi. 

SGN(Y) 

Se Y > 0 allora SGN ritorna 1, se Y = 0 allora viene ritornato 0, altri- 
menti — 1. 

S1N(Y) 

Ritorna il seno dell’espressione Y considerata espressa in radianti. 
SOUND registro, Y 
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L’istruzione SOUND scrive il valore dell’espressione Y nel registro speci- 
ficato del PSG. Y deve essere compreso neU’intervallo 0 - 255, estremi com- 
presi. Per maggiori dettagli si veda il capitolo sull’AY-3-8910. 

Esempio: SOUND 4,4 

SPACE$(Y) 

Ritorna una stringa composta da Y spazi. Y compreso tra 0 e 255. 
SPC(Y) 

Viene usata in unione con le istruzioni PR1NT e LPR1NT al fine di pro- 
durre Y spazi. Y compreso tra 0 e 255. 

Esempio: ?SPC(4);“SOVRASCRIVE“ 

SPRITES(Y) = "stringa di definizione" 

Variabile di sistema per le definizione del modello di uno sprite. Il codice 
carattere per ciascun carattere della stringa allocata è il modello di un byte 
dello sprite. La forma binaria consente una definizione di sprite più agevole: 

CHR$(&1010101 1) 

Se si stanno usando gli sprite a 16 * 16 pixel, possono essere definiti fino 
a 64 sprite (Y compreso tra 0 e 63). Quando invece si usano gli sprite qua- 
drati 8*8 pixel si possono definire addirittura fino a 255 modelli. Per ul- 
teriori dettagli si consulti il Capitolo 2. 

SPRITE ON /OFF / STOP 

Attiva, disattiva o sospende la chiamata di un sottoprogramma all’avve- 
nire di una collisione tra due sprite. L’istruzione ON SPRITE GOSUB de- 
ve essere stata precedentemente usata per specificare quale routine debba 
essere attivata. 

Esempio: SPRITE STOP sospenderà l’attivazione di sottoprogrammi in 
occasione della collisione tra due sprite. Per far sì che la chiamata sia ef- 
fettivamente attiva è necessaria un’istruzione SPRITE ON 

SQU(Y) 

Ritorna la radice quadrata dell’espressione Y che deve essere maggiore o 
uguale a zero. 
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STICK(Y) 

Y può assumere valori da 0 a 2: 

0 Cursore 

1 Joystick porta 1 

2 Joystick porta 2 

Viene ritornata la direzione secondo il seguente schema di trascodifica: 

1 

8 I 2 

7 — 0 — 3 

6 I 4 

5 



STOP 

Istruzione che provoca l’interruzione dell’esecuzione del programma; nello 
stesso tempo viene visualizzato il messaggio: 

"Break in" 



numero di linea. 

STOP ON / OFF / STOP 

Attiva, disattiva o sospende la chiamata a un sottoprogramma particolare 
allorché vengono premuti i tasti di CTRL e STOP. Per maggiori dettagli 
si consulti il Capitolo 2. 



STRIG(Y) 

L’espressione intera Y deve essere compresa tra 0 e 4: 



0 Barra di spaziatura 

1 Segnale 1 dal joystick 1 

2 Segnale 1 dal joystick 2 

3 Segnale 2 dal joystick 1 

4 Segnale 2 dal joystick 2 
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Quando si preme il tasto del joystick viene ritornato — 1, 0 altrimenti. 
STRIG (Y) ON / OFF / STOP 

Attiva, disattiva o sospende la rilevazione di quando viene premuto un par- 
ticolare tasto di joystick (o la barra spaziatrice). Y, come nel caso prece- 
dente, deve essere tra 0 e 4. Per definire il sottoprogramma che viene atti- 
vato alla rilevazione dell’evento di cui sopra, è necessario usare un’istruzio- 
ne ON STRIG GOSUB. 

Esempio: STRIG(O) ON abilita la rilevazione della pressione della barra 
di spaziatura. 

STRING$(x,Y) 

Variante: STRING$(x,Y$) 

Ritorna una stringa di lunghezza x contenente solo i caratteri che hanno 
codice di carattere Y, oppure il primo carattere di Y$. Sé il primo caratere 
è grafico, viene ritornata una stringa di CHR$(1). 

Esempio: STRING$(4,65) ritorna “AAAA”. 

STR$(Y) 

Ritorna la rappresentazione in formato stringa del valore numerico dell’e- 
spressione Y. In questo modo si dispone di un conveniente metodo di con- 
versione da esadecimale, ottale o formato esponenziale. 

SWAP Y,X 

Scambia i valori delle variabili indicate. Entrambe devono essere dello stes- 
so tipo. 

Esempio: A$ = “w“:B$ = “e“:SWAP A$,B$:? A$ visualizzerà “e”. 

TAB(Y) 

Funzione che può essere usata solo dopo le istruzioni PRINT o LPRINT. 
TAB sposta la stampa della prossima entità alla colonna Y - a meno che 
vi si trovi già, nel qual caso non viene intrapresa alcun’azione. Y deve esse- 
re compreso tra 0 e 255. 

EsempiotPRINT TAB(4);“Sulla quarta colonna" 

TAN(Y) 
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Funzione trigonometrica che ritorna il valore della tangente dell’espressio- 
ne Y, valutata in radianti. 

TIME 

Speciale variabile intera che viene azzerata al momento dell’accensione e 
incrementata ogni 1/50 di secondo. Questo aggiornamento avviene duran- 
te l’interruzione di sistema del VDP che viene però sospesa durante le ope- 
razioni di ingresso e uscita su nastro. 

TRON / TROFF 

L’istruzione TRON fa in modo che ogni linea del programma venga visua- 
lizzata non appena è stata eseguita. Quest’istruzione può essere attivata sia 
in modalità diretta sia in quella indiretta (interpretata) e viene negata dalla 
TROFF. 

Esempio: 

10 TRON 
20 REM 
30 REM 
40 TROFF 

provocherà la visualizzazione di [20], [30], [40] 

Z = USR (Y) 

Variante: Z = USR x (Y) 

Quest’istruzione esegue una chiamata alla routine in codice macchina po- 
sta alla locazione specificata dall’istruzione DEFUSRx. Il valore dell’espres- 
sione Y viene passato alla routine. Se non deve essere trasferito alcun para- 
metro è necessario dare un valore fittizio a Y. 

Al completamento della routine in codice macchina viene restituito un va- 
lore che viene assegnato a Z. 

Sia al momento della chiamata che in quello del ritorno, l’elemento scam- 
biato si trova alla locazione &HF7F6. Il tipo di dato è indicato dal valore 
dell’àccumulatore: 

Intero: 2 

Stringa : 3 

Singola precisione: 4 
Doppia precisione: 8 
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La locazione di un elemento stringa viene comunicata per mezzo della coppia 
DE di registri. Un tal elemento consiste di tre byte: 

1. Il numero di caratteri della stringa. 

2. e 3. La locazione effettiva ove è memorizzata la stringa. 

Esempio: 

10 DEFUSR4 = &HD000 
20 Y = USR 4 (X) 

VAL(Y$) 

Ritorna il valore numerico della stringa YS. Qualsiasi spazio, carattere di 
tabulazione o linea nuova viene ignorato. 

VARPTR(Y) 

Variante: VARPTR( # numero di file) 

Funzione che ritorna la prima locazione della variabile specificata. 

È applicabile a un qualsiasi tipo di variabile. Se viene ritornato un indiriz- 
zo negativo, è necessario aggiungervi 65536 per ottenere la locazione reale 
desiderata. 

Per maggiori dettagli si consulti la sezione 'Memorizzazione del program- 
ma’ al termine del Capitolo 2. 

La variante con il numero di File consente di ottenere l’indirizzo del primo 
elemento del blocco di controllo del file. 

VDP(Y) 

Si tratta di una speciale variabile in cui Y deve essere compreso tra 0 e 8. 
I valori da 0 a 7 ritornano il valore del registro a sola scrittura del VDP. 
VDP(8) permette di ottenere il valore del registro di stato del VDP. Per mag- 
giori dettagli si faccia riferimento alla sezione sul VDP. 

VPEEK(indirizzo) 

Ritorna il valore contenuto nell’elemento della VRAM di cui si è specifica- 
to l’indirizzo. Quest’ultimo deve essere compreso tra 0 e 16383. 

VPOKE X,Y 

Funzione per scrivere il valore Y all’indirizzo X nella VRAM. Y deve esse- 
re compreso nell’intervallo tra 0 e 255. 
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WAIT porta, valore di un byte 

Variante: WAIT porta, valore di un byte, maschera. 

Istruzione che sospende il programma in attesa che un byte venga acquisi- 
to dalla porta indicata. La configurazione dei bit del byte acquisito deve 
essere la medesima del valore del byte specificato nell’istruzione. 

La variante consente invece di operare dapprima un OR tra la maschera 
e il byte in ingresso e successivamente di effettuare un AND tra i bit del 
risultato e quelli del byte specificato. 

Tutte le suddette espressioni devono assumere valori interi tra 0 e 255. 
WIDTH larghezza dello schermo di testo 

Istruzione che consente di precisare la larghezza dello schermo in entram- 
be le modalità testo. 

I valori indicati devono essere compresi: 

a) tra 1 e 40 per la modalità testo 40 * 24. 

b) tra 1 e 32 nella modalità 32 * 24. 

Esempio: WIDTH 20. 
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Capìtolo 4 

IL LINGUAGGIO MACCHINA 
DELLO Z-80 

Microprocessori. L’architettura Z-80. Le istruzioni. 

I modi di indirizzamento 



Microprocessori 

Il cuore di ogni elaboratore basato sul sistema MSX è costituito da un mi- 
croprocessore Z-80. Esso può essere programmato direttamente usando il 
codice macchina e possiede tre caratteristiche essenziali: 

1. Semplicità nello svolgimento di operazioni aritmetiche. 

2. Spostamento di dati tra locazioni diverse. 

3. Operazioni logiche. 

Un programma, chiamato interprete BASIC, è scritto in codice macchina 
nella ROM di sistema (read only memory = memoria a sola lettura). Que- 
sto programma traduce le istruzioni BASIC in codice macchina che quindi 
vengono eseguite dallo Z-80. 

La mancanza di questa fase di traduzione consente ad un programma scritto 
in codice macchina di poter essere eseguito più rapidamente rispetto ad uno 
analogo scritto in BASIC. Da qui deriva la definizione del BASIC che lo 
indica come linguaggio ad “alto livello” che permette l’uso di comandi non 
direttamente disponibili al livello intrinseco del microprocessore. 

Quindi la velocità è il principale vantaggio che si ottiene dall’uso del codi- 
ce macchina, ma quali sono gli svantaggi? Così come il BASIC è stato pro- 
gettato per consentire l’utilizzo e la programmazione dell’elaboratore con 
poca esperienza pratica, l’uso del linguaggio macchina richiede un più alto 
grado di conoscenza di quel che accade all’interno della macchina, dei si- 
stemi di numerazione binario ed esadecimale - sftratta comunque di pic- 
coli inconvenienti rispetto ai sorprendenti risultati che si possono ottenere. 
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Sappiamo già che nei sistemi che stiamo considerando c’è uno Z-80, af- 
fiancato da un 9129 VDP (processore video) e da un integrato per la pro- 
duzione di suoni, l’AY-3-8910; ma come sono interconnessi tra loro? 

La comunicazione tra le varie unità avviene attraverso due principali cana- 
li: il bus dati ed il bus indirizzi. Il bus indirizzi è costituito da 16 linee che 
corrono dallo Z-80 fino ai blocchi di memoria RAM e ROM. Il bus dati, 
parallelo al primo, è composto solo da otto linee. 

Usando le 16 linee del bus indirizzi, lo Z-80 è in grado di accedere ad una 
qualsiasi locazione tra 0 e 65535. Ciascuna locazione, sia essa in memoria 
RAM o ROM, può contenere un valore tra 0 e 255. 

Quando lo Z-80 scrive un indirizzo sul bus indirizzi e indica alla memoria 
che deve essere effettutata un’operazione di lettura piuttosto che una di scrit- 
tura, il numero contenuto alla locazione indicata viene automaticamente 
messo sul bus dati. Quindi il processore lo copia in un registro interno. 
Poiché il sistema necessita di essere esattamente sincronizzato viene usato, 
come riferimento, un “temporizzatore elettronico” (clock), esterno allo Z-80, 
che lavora ad una frequenza di 3.57 MHz. 

Anche il VDP ha accesso al bus dati per consentire alla CPU (unità centra- 
le di elaborazione, lo Z-80) di passare dati ed istruzioni. Inoltre il VDP pos- 
siede una RAM di 16 Kbyte, alla quale solo lui può accedere direttamente. 
Per questo motivo esso dispone di un bus ad 8 bit 'privato’ e bidirezionale. 
A partire dalle istruzioni d’impostazione della modalità di visualizzazione 
e dal contenuto della VRAM, il VDP costruisce la schermata che deve es- 
sere visualizzata. Quest’ultima viene trasmessa direttamente a un monitor 
o viceversa modulata per un apparecchio TV domestico. 

Al momento dell’accensione, la definizione dell’insieme dei caratteri con- 
servata nella ROM viene trasferita dalla CPU (lo Z-80) al VDP e da questo 
alla VRAM. 



Organizzazione del sistema 

La gestione di aree di memoria di dimensioni pari a quelle suddette viene 
semplificata se si considera l’intera area di cui si dispone come divisa logi- 
camente in blocchi dalle dimensioni più piccole. Una divisione piuttosto 
comune è quella che fa riferimento a pagine di 256 locazioni ciascuna. La 
prima di queste pagine è la pagina 0 e contiene gli indirizzi assoluti dallo 
0 a 255. Il termine “pagina” può anche riferirsi a un blocco di memoria 
di 16K byte. Il tempo impiegato dalla CPU per trasferire dati da e sulla 
pagina zero è inferiore a quello richiesto nel caso in cui si debba attraversa- 
re il confine tra due pagine. Di conseguenza la maggior parte dei piccoli 
elaboratori riservano la pagina zero ad uso del sistema. 
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Le istruzioni per il microprocessore sono in forma di uno o due byte. Se 
inoltre è necessario specificare, come operandi dell’istruzione, dati o indi- 
rizzi, devono essere usati altri byte. 

Ne consegue che un programma in linguaggio macchina ha la forma di una 
sequenza continua di byte di istruzioni e dati. 

Certe locazioni di memoria interne al processore sono accessibili al pro- 
grammatore. Le più utili tra queste sono: 

1 . Il “program counter” (contatore che memorizza l’indirizzo della prossi- 
ma istruzione da eseguire). 

2. Il puntatore dello stack (o pila). 

3. Due registri indice: IY e IX. 

4. L’accumulatore, o registro A. 

5. Sei registri generali da B a L. 

6. Il registro di “flag” F. 

7. I registri d’interruzione e di refresh I ed R. 

8. Un insieme alternativo di registri da A’ a L’. 

I registri dall’l al 3 dispongono di 16 bit e possono quindi contenere un 
qualsiasi numero tra 0 e 65535. I restanti sono da otto bit e sono limitati 
all’intervallo da 0 a 255. 

Poiché il processore deve sapere dove sono poste le istruzioni, il program 
counter assolve a questa funzione mantenendo sempre memoria dell’indi- 
rizzo della prossima istruzione che deve essere eseguita. 

II registro di “flag” mantiene informazioni che concernono sia lo stato del 
sistema, sia il risultato di alcune determinate operazioni. Per esempio, se 
il risultato di una sottrazione fosse negativo, verrebbe posto a 1 il bit di 
segno (S) del registro F. 

Il registro di flag viene usato da quelle istruzioni che consentono di effet- 
tuare salti condizionati all’interno del programma. Queste istruzioni fan- 
no si che il program counter punti alla locazione dell’istruzione voluta se 
uno dei bit del registro F vale 1 o piuttosto 0. 

1 due registri indice IY ed IX possono essere caricati con qualsiasi valore, 
compreso nell'intervallo di validità, desiderato dal programmatore. Princi- 
palmente questi indirizzi sono stati concepiti per mantenere indirizzi di dati 

0 di procedure. 

1 sei registri generali: B, C, D, E, H, L possono anch’essi contenere un qual- 
siasi valore; in alternativa possono essere usati a coppie, BC, DE, HL, per 
fornire registri a 16 bit. 

Il registro A o accumulatore ha una particolare importanza che gli deriva 
dall’architettura dello Z-80. La maggior parte delle operazioni logiche ed 
aritmetiche su 8 bit richiedono che uno dei dati di partenza sia stato pre- 
ventivamente caricato nell’accumulatore. Dopo l’operazione, il risultato viene 
nuovamente posto in A. 
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Sebbene questo consenta di eseguire le suddette operazioni in modo rapi- 
do, vengono in tal modo a rendersi necessarie istruzioni per il caricamento 
dell’accumulatore e per il trasferimento finale del risultato. Lo Z-80 può 
anche effettuare addizioni o sottrazioni a 16 bit. In questo caso la coppia 
di registri HL sostituisce il registro A. L’insieme dei registri da A’ a L’ può 
essere selezionato alternativamente all’insieme da A a L: in questo modo 
si dispone di due insiemi separati per la memorizzazione e gestione dei da- 
ti. In pratica però il secondo insieme è usato assai raramente - usualmente 
per consentire un rapido servizio delle procedure di gestione delle interru- 
zioni. 



Rappresentazione binaria ed esadecimale 

Prima di affrontare questa sezione, provate a rispondere a questi due quesiti: 

1. Quali sono le rappresentazioni binarie di — 34 e di 0.02? 

2. Qual è il numero decimale equivalente all’esadecimale &H0FDE ? 

’ Poiché i microprocessori non sono stati progettati per usare il sistema di 
numerazione decimale, chi programma in codice macchina deve essere a 
perfetta conoscenza sia del sistema di numerazione binario sia di quello 
esadecimale. 

In decimale si possono usare dieci cifre, in binario soltanto due: 0 e 1, quindi 
un numero binario è una serie di 0 e di 1. 

Un’altra importante differenza è la seguente: in decimale il passaggio da 
una posizione all’altra nella scrittura di un numero si ha quando si passa 
una decina mentre in binario la si ha per potenze di due. 

Per convertire un numero binario in decimale, è necessario sommare i va- 
lori rappresentati nelle colonne ove c’è un 1. Nella figura 4.1 l’equivalente 
in binario di 100 viene calcolato come somma di potenze di due, cioè come 
64 + 32 + 4. Ciascun uno o zero viene rappresentato da un bit, mentre 
una serie di otto bit viene detta byte. 

Chiaramente il massimo numero rappresentabile in un byte è 128 + 64 + 
32 + 16 + 8 + 4 + 2+1= 255. Per numeri più piccoli è comunque 
conveniente indicare gli zeri che sono nei primi degli otto bit. 

Il bit più a destra è detto meno significativo (l.s.b. dall’inglese least signifi- 
cant bit) mentre quello più a sinistra è il bit più significativo (m.s.b. dall’in- 
glese most significant bit). Queste abbreviazioni non vanno comunque con- 
fuse con L.S.B. (byte meno significativo) e M.S.B. (byte più significativo). 
Per esempio, in un indirizzo a sedici bit: 

1111111100000010 



82 




Decimale Rappresentazione Binaria 
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0=128 + 64-1-8 



Fig. 4.1 - Valori binari 



il l.s.b. è 0, il m.s.b. è 1 mentre il M.S.B. è 11111111. 

Nei capitoli seguenti avremo spesso bisogno di riferirci ad un bit particola- 
re nell’ambito di un byte. Useremo la notazione convenzionale: 

76543210 

L’addizione e la sottrazione in binario sono piuttosto semplici con una ec- 
cezione - la rappresentazione di un numero negativo. Poiché non si dispo- 
ne di qualcosa di analogo al segno meno, i numeri negativi sono rappre- 
sentati diversamente. Il metodo per codificarli è la notazione in comple- 
mento a due. Questa si ottiene considerando il valore assoluto del numero 
che si vuole convertire, rappresentandolo in binario, invertendo tutti i bit 
ed infine aggiungendo 1. 

Per esempio, per ottenere il complemento a due di — 12 considerate la rap- 
presentazione binaria del suo valore assoluto (12) che è 00001100. Inverten- 
do i bit si ottiene 11110011 ed aggiungendo 1 si ha 11110100. Poiché il pro- 
cessore deve poter distinguere questo numero da 244, che ha la medesima 
rappresentazione, vengono imposti i limiti superiore ed inferiore ai valori 
che possono essere rappresentati in un byte: — 128 e 127. Questo evita ogni 
sovrapposizione. 
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Operazione 


Esempio 


Valore negativo 


—121 


Valore assoluto 


121/01111001 


Forma inversa 


10000110 


Incremento 


00000001 


Complemento a due 


10000111 



Fig. 4.2 - Rappresentazione di numeri negativi in binario 



La divisione per due di un numero binario si ottiene muovendo tutti i bit 
di una posizione verso destra. Quindi per ottenere la rappresentazione bi- 
naria di 1/2, il byte 00000001 viene spostato quindi da 0.1. La figura 4.3 
mostra i valori binari frazionari. 


Decimale 


Frazione binaria 


0.5 


0.1 


0.25 


0.01 


0.125 


0.001 


0.0625 


0.0001 


0.03125 


0.00001 



Fig. 4.3 - Rappresentazione di frazioni in binario 



Ogni numero rappresentato su otto bit può essere spezzato per dar luogo 
a due semi-byte (“nibble”)- Ciascuno di questi può rappresentare, isola- 
tamente, un numero da 0 a 15. In questo modo si ottiene un utile e abbre- 
viata rappresentazione di dati binari: occorrono chiaramente 16 differenti 
cifre, ragion per cui, oltre alle solite da 0 a 9, si usano le prime lettere del- 
l’alfabeto, da A a F. 



Decimale 0123456789 10 11 12 13 14 15 16 17 

Esadecimale 0 1 2 3 4 5 6 7 8 9 A B C D E F 10 11 

Fig. 4.4 - Notazione esadecimale 



Questo metodo di rappresentazione è il sistema di numerazione esadeci- 
male. Per esempio, per convertire 56 decimale in esadecimale si consideri 
dapprima la rappresentazione binaria: 00111000 da cui si estrae il valore 
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dei due semi-byte: 0011 e 1000, vale a dire 3 e 8; se ne deduce che la forma 
esadecimale di 56 è 38. 

Ciò che segue dimostra un’altra semplificazione rispetto al sistema bina- 
rio. Per convertire un numero di due cifre esadecimali in decimale, è suffi- 
ciente moltiplicare per 16 la cifra più a sinistra e poi aggiungervi quella 
sulla destra. 

Come avrete intuito la base del sistema esadecimale è 16. Quindi per con- 
vertire da decimale a esadecimale è solo necessario scomporre il valore se- 
condo potenze di 16. 



Esadecimale 4 3 A 4 

Valore posizionale 4096 256 16 1 

Valutazione 4*4096+ 3*256+ 10*16 +4 =17316 

Fig. 4.5 - Conversione da esadecimale a decimale 



Operazioni logiche 

Considerate il seguente problema: 

Dati due numeri binari di 8 bit, si richiede di formare un terzo numero 
binario in cui ogni bit sia a 1 se, e soltanto se, i bit omologhi di entrambi 
i numeri dati sono a 1. 

La risposta? Semplice, prima caricate uno dei due valori dati nel registro 
A, quindi effettuate l’operazione logica di AND tra esso e l’altro byte. Al 
termine dell’operazione il risultato viene ritornato nel registro A. 
L’operazione di AND è una delle tre operazioni logiche che lo Z-80 è in 
grado di compiere: i bit di due byte vengono confrontati a uno a uno e, 
in base al risultato del confronto, un nuovo valore viene scritto nell’accu- 
mulatore. Come abbiamo visto l’operazione di AND mette a 0 tutti i bit 
tranne quelli in cui entrambi gli operandi hanno 1. L’operazione inversa a 
questa è l’istruzione OR, che ritorna 1 in ciascun bit dell’accumulatore quan- 
do uno o entrambi i bit degli operandi nella stessa posizione sono a 1. La 
terza istruzione, XOR, è un incrocio delle due precedenti. Perché in un bit 
dell’accumulatore sia posto 1 è necessario che i bit di analoga posizione 
negli operandi siano tra loro diversi. 

A chi affronta per la prima volta i problemi del codice macchina queste 
operazioni sembreranno senza importanza: al contrario esse sono spesso 
necessarie per certi calcoli e per il controllo di particolari funzioni. 
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Operazione 


AND 


XOR 


OR 


Condizione 


Entrambi gli 


I bit dei due 


Uno o entrambi 


per risultato 


operandi a 1 


operandi sono 


gli operandi 


uguale a 1 


nella colonna 


diversi 


sono a 1 



Fig. 4.6 - Confronto tra le operazioni logiche di base 



L’architettura Z-80 

La Zilog ha realizzato molte versioni dello Z-80 che si differenziano per 
la massima velocità a cui possono funzionare. Per lo Z-80A, utilizzato nel 
MSX, la massima velocità di sincronismo è di 4 Mhz (mentre lo Z-80B può 
arrivare a 6MHz). 

La configurazione strutturale del processore è un tipico 40 piedini “Dual 
in Line Package” (D.I.L.P.). Il bus indirizzi richiede 16 linee e il bus dati 
otto. I principali piedini rimanenti hanno le seguenti funzioni: 

1. Alimentazione 

2. Piedini di reset e di interruzione: RESET, INT e NM1. 

3. WA1T: impone una pausa al processore, tipicamente per consentire una 
ricerca in memoria dei dati necessari. 

4. BUSREQ e BUSAK - linee di controllo che consentono ad altri proces- 
sori di accedere ai bus dati ed indirizzi. 

5. RFSH - indica che le 7 linee di indirizzo più basso sono in uso per il 
refresh di parte della memoria. 

6. Piedini di ingresso per il sincronismo di sistema (clock). 

7. Piedini di lettura e scrittura (RD e WR). 

8. Piedini MREQ e IORQ. 

Inoltre, per poter trasferire dati da e sulla memoria, il processore può ac- 
quisire o scrivere dati su porte a 8 bit, in numero massimo di 256. I princi- 
pali registri di controllo del sistema sono accessibili in questo modo. Que- 
sto consente di iniziare la maggior parte delle operazioni di ingresso/uscita 
scrivendo semplicemente sulla porta interessata. 

Per ottenere l’attenzione del processore onde poter compiere una funzione 
urgente, un componente del sistema può generare un’interruzione. In que- 
sto caso lo Z-80 finisce di eseguire l’istruzione corrente e poi salta ad ese- 
guire la procedura di gestione dell’interruzione. Dopo il suo completamen- 
to, il controllo ritorna al programma che era in esecuzione in precedenza. 
Spesso non è necessario ricorrere ad una procedura d’interruzione qualora 
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sia richiesto solo l’uso del bus dati o indirizzi. Infatti lo Z-80 è in grado 
di isolarsi dai due bus. La linea BUSREQ viene usata per richiedere all’u- 
nità centrale l’uso dei bus, e quest’ultima usa la linea BUSAK per notifica- 
re il suo avvenuto isolamento. 

La linea MREQ viene usata per indicare che il processore deve effettuare 
una lettura o una scrittura in memoria e quindi ha messo un indirizzo sul 
bus indirizzi. La linea IORQ viene abbassata sia per comunicare che una 
interruzione è stata ricevuta, sia per indicare che sta avendo luogo un’ope- 
razione di I/O. 

Internamente lo Z-80 comprende un’unità aritmetico logico (A.L.U.), una 
unità di controllo, alcuni registri e della memoria a sola lettura. Il loro mo- 
do di funzionamento viene illustrato chiaramente se si considera un esempio: 

i. Viene fatto un accesso all’indirizzo puntato dal contatore di istruzioni 
del programma (program counter) e il suo contenuto viene caricato nel re- 
gistro istruzioni. Nel nostro esempio sia tale valore 01111100, 124 in deci- 
male. Quest’istruzione viene interpretata dal processore come un ordine di 
caricare il contenuto del registro H nell’accumulatore A. 

ii. L’unita di controllo centrale incrementa il contatore di istruzioni del pro- 
gramma che così punta ora all’istruzione successiva. 

iii. Il byte che si trova nel registro H viene copiato nel registro A. In tal 
modo ogni suo precedente valore viene sovrascritto. 

iv. Nel processore viene caricata l’istruzione successiva. 

L’intera operazione viene completata in 4 T cicli (periodi del sincronizzato- 
re esterno). Questo dà un’idea della temporizzazione del sistema - e chiari- 
sce inoltre perché gli errori di programma siano così difficilmente rintrac- 
ciabili! Sebbene in confronto a molti altri processori a 8 bit lo Z-80 sia ben 
fornito di registri interni, essi spesso si rivelano insufficienti per memoriz- 
zare le informazioni di cui abbiamo bisogno sottomano. Fortunatamente 

10 Z-80 dispone di uno spazio di memoria più ampio, lo stack o pila. 
Lo stack è una sezione di memoria che può essere usata per memorizzare 
dati di due byte ciascuno. Tali dati possono provenire da uno qualsiasi dei 
registri a 16 o bit da una coppia di altri registri, ad eccezione del contatore 
d’istruzioni del programma. 

11 nome stack, pila, è appropriato, solo che in realtà, in memoria la pila 
è rovesciata! Infanti quando una coppia di byte viene aggiunta, o messa 
sullo stack, la sua cima viene spostata due posizioni più in basso nella me- 
moria. La locazione dell’ultimo byte della coppia messa sullo stack viene 
ricordata dal registro puntatore allo stack. 

Uno svantaggio implicito nell’uso dello stack è che le coppie di byte devo- 
no essere usate sulla base di una strategia “ultimo entrato primo uscito” 
(in inglese L.I.F.O. = last in first out). 
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Esempio: Il contenuto del registro a 16 bit IY viene messo sullo stack se- 
guito dal contenuto della coppia di registri BC. Per accedere alla prima cop- 
pia messa sullo stack è necessario prima utilizzare la seconda. Lo stack viene 
inoltre usato per memorizzare gli indirizzi di ritorno da sottoprogrammi 
o da procedure di gestione d’interruzioni. 

Prima che vi sia presentato l’insieme delle istruzioni macchina, alcune pa- 
role sulle 256 porte di ingresso/uscita. È possibile leggere o scrivere un da- 
to di un solo byte da una qualsiasi porta usando l’istruzione appropriata. 
Il processore usa le otto linee meno significative, da AO a A7, per selezio- 
nare la porta (non viene fatta una lettura o scrittura in memoria poiché 
è alta la linea IORQ e non la MREQ). Il dato viene quindi posto sul bus 
dati e viene utilizzato o dallo Z-80 (READ) o dalla porta (WRITE). 



Le istruzioni dello Z-80 

Lo Z-80 ha 158 istruzioni macchina che la Zilog raggruppa in 11 categorie. 
Prima di considerarle, è necessario comprendere in che modo scrivere o 
acquisire programmi in linguaggio macchina. 

Dando un rapido sguardo alle pubblicazioni sui computer ci si rende conto 
che esistono due metodi comuni per rappresentare le procedure scritte in 
linguaggio macchina. Il più diffuso di questi metodi consiste nel listare i 
valori esadecimali che, rappresentandone le istruzioni, compongono il pro- 
gramma stesso. L’utente scrive semplicemente questi valori nelle appropriate 
locazioni di memoria: il programma viene poi eseguito accedendo alla pri- 
ma locazione ad esso riservata, per mezzo dell’istruzione USR del BASIC. 
I byte in questione vengono detti codice oggetto, in questo formato la se- 
quenza delle istruzioni può essere elaborata direttamente dallo Z-80. 
Però mettere manualmente in memoria un programma byte dopo byte è 
un procedimento laborioso e con un alto rischio di errore. Una semplice 
soluzione consiste nello scrivere una routine BASIC che acquisisca numeri 
esadecimali di due cifre. Essa stessa metterà poi in memoria, in una serie 
di locazioni, l’equivalente decimale di tali numeri. Un programma BASIC 
di questo genere viene di solito detto un “caricatore esadecimale”; di segui- 
to ne viene fornito un esempio: 

CARICATORE ESADECIMALE 

200 SCREEN ItCOLOR 10,1.1 :CLS 

210 LOCATE 2,2:?''HEX LOADER FI TO FINISH”:? 

220 INPUT"START LOCATION";ST 
230 SW = ST— 1 :? 
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240 SW = SW+ 1:?SW;‘‘";HEX$(SW);‘'??“; 

250 ?CHR$(29);CHR$(29); 

260 A$ = INPUT$(2) 

270 IF A$ = "FI" OR A$ = “fì" THEN 320 
280 A$(1 ) = MI D$(A$, 1 , 1 ):A$(2) = M I D$(A$,2, 1 ) 

290 IF INSTR('‘0123456789ABCDEFabcdef“,A$(1)) = 0 OR INSTR 
("0123456789ABCDEFabcdef“,A$(2)) = 0 THEN 260 ELSE ?A$; 
300 A = VAL("&H"+A$):?“";A 
310 POKE SW,A:?:GOTO 240 
320 ?:?:?:?“START “;ST;“ END 'LSW— 1 



Ciò nonostante, se il programma in linguaggio macchina è di una lunghez- 
za non indifferente, il procedimento di cercare l’equivalente in esadecimale 
di ogni istruzione diventa di scarsa praticità e quindi è necessario usare un 
assemblatore. 

Un programma assemblatore (o Assembler, una sorta di compilatore per 
il linguaggio Assembly) consente di scrivere una procedura usando dei sim- 
boli mnemonici per le istruzioni e, se necessario, stringhe per indicare indi- 
rizzi. Il file sorgente viene tradotto in codice oggetto per mezzo dell’assem- 
blatore. Quando si è raggiunta una certa familiarità con le istruzioni sim- 
boliche, la scrittura di programmi in codice macchina risulta agevole tanto 
quanto scriverli usando il BASIC. Il file sorgente di solito consiste di linee 
numerate, ciascuna delle quali contiene una o più istruzioni in linguaggio 
macchina. Tutti gli assemblatori che si rispettino permettono l’uso dell’edi- 
tor a schermo intero ed hanno comandi di una sola lettera. 

La maggior parte degli assemblatori reperibili in commercio consiste di tre 
pacchetti: 

1. Assemblatore 

2. Monitor 

3. Disassemblatore 

Una volta che il file sorgente è completo, esso viene assemblato e se ne ot- 
tiene un codice oggetto. Il file viene quindi salvato poiché potrebbe conte- 
nere degli errori per i quali sia necessario spegnere l’elaboratore prima di 
poter rieseguire il programma. Alla fine si fa uso del monitor per seguire 
l’esecuzione - una istruzione alla volta se necessario. Il disassemblatore viene 
usato per esaminare e cambiare aree di memoria e di solito fa ad esso rife- 
rimento il monitor. 

Oltre a queste operazioni di base viene fornito un insieme secondario di 
istruzioni tipicamente per spostare, salvare o caricare blocchi di memoria, 
effettuare operazioni di ricerca su stringhe, ecc. 
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Secondo l’attività di programmazione che si sta svolgendo al momento, si 
può scegliere quale dei tre suddetti programmi utilizzare. 11 prezzo di que- 
sti pacchetti è accessibile: da qualche migliaio di lire in sù. Per un uso sal- 
tuario può essere sufficiente un sistema basato su nastro a cassetta, ma per 
un impiego più serio è quasi obbligatorio ricorrere a periferiche più veloci. 
La ragione principale di ciò è che quasi tutti i programmi in linguaggio mac- 
china conteranno inizialmente degli errori, e dover ricaricare l’intero pac- 
chetto dopo ogni errore, in seguito al quale la situazione non è ripristinabi- 
le, può diventare causa di irritazione. 

Sebbene esistano 158 tipi di istruzioni supportati dal processore, i codici 
operativi singoli sono in totale 666. Questo accade perché la maggior parte 
delle categorie di istruzioni contiene un insieme di operazioni, ciascuna delle 
quali compie la medesima operazione delle altre, ma consente di indicare 
gli indirizzi in modo diverso. 

Lo Z-80 consente di usare 10 diverse modalità di indirizzamento, modalità 
che verranno esaminate più dettagliamente nella prossima sezione. Il me- 
nù delle istruzioni di cui si dispone può essere diviso nelle seguenti categorie: 

1. Istruzioni di caricamento a 8 e 16 bit. 

2. Istruzioni aritmetiche a 8 e 16 bit. 

3. Istruzioni logiche a 8 bit. 

4. Istruzioni di rotazione e spostamento laterale di bit. 

5. Istruzioni sui bit. 

6. Istruzioni di salto e di sottoprogramma. 

7. Istruzioni di trasferimento di blocchi e di ricerca. 

8. Istruzioni di controllo dell’unità centrale e delPI/O. 

Istruzioni di caricamento a 8 e 16 bit 

Un’istruzione di caricamento a 8 bit copia il contenuto di un registro o di 
una locazione di memoria in un altro registro o locazione di memoria. L’i- 
struzione a 16 bit effettua un’operazione equivalente tra un registro a 16 
bit e la memoria o un altro registro. 

Si noti che quando un valore a 16 bit viene memorizzato alla locazione X, 
il byte più significativo viene memorizzato nella locazione X 4- 1, mentre 
quello meno significativo finisce nella locazione X. In modo analogo se 
viene caricato un registro a 16 bit con due byte alla locazione X, allora il 
valore contenuto all’indirizzo X + 1 viene caricato negli 8 bit più signifi- 
cativi del registro, mentre il contenuto della locazione X finisce negli 8 bit 
meno significativi. 

L’istruzione simbolica per l’assemblatore Zilog per questa operazione è LD 
X,Y dove Y è il byte che vien copiato nella locazione o registro X. 
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Esempi: 

LD A,B carica nel registro A il contenuto del registro B. 

LD H,A carica nel registro H il contenuto del registro A. 

LD B,40 carica 40 nel registro B. 

Se un operando è racchiuso tra parentesi, indica l’indirizzo del dato che 
deve essere usato. 

LD A, (40) carica nell’accumulatore il contenuto della locazione 40. 

In modo analogo LD B,(HL) carica nel registro B il byte il cui indirizzo 
è nella coppia HL di registri. Ecco infine due esempi di caricamento a 16 bit: 

LD HL,(40) carica nel registro L il contenuto della cella 40 e in H quello 
della cella 4L 

LD IY,22 carica 22 nel registro indice IY. 



Istruzioni aritmetiche a 8 e 16 bit 

Le più semplici sono le istruzioni per incrementare e per decrementare: ser- 
vono per aggiungere o sottrarre 1 al dato indicato. In simbolico sono INC 
e DEC. 

Esempi: 

INC A aggiunge 1 al valore dell’accumulatore. 

DEC IX sottrae 1 al valore del registro indice IX. 

Esistono due istruzioni simboliche per ognuna delle due operazioni di ad- 
dizione e sottrazione: ADD e ADC per l’addizione e SUB e SBC per la sot- 
trazione. ADD e SUB hanno l’ovvio significato che ci si attende da queste 
operazioni. In particolare per operazioni a 8 bit il risultato viene posto nel 
registro A, mentre in quelle a 16 bit il risultato va nella coppia di registri 
HL. Per sommare 4 e 5, prima si carica A con uno dei due valori: 

LD A, 4 

e quindi si aggiunge 5: 

ADD A, 5 

Il risultato sarà contenuto nel registro A. Come abbiamo detto per le addi- 
zioni e sottrazioni a 8 bit è obbligatorio usare II registro A. Analogamente, 
nelle operazioni a 16 bit, si deve dapprima caricare uno dei valori nella coppia 
HL e in essa verrà posto il risultato (con l’eccezione, che conferma la rego- 
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la, che un registro indice può essere usato come accumulatore per una cer- 
ta categoria di addizioni a 16 bit). 

Esempio: ADD HL,BC somma il contenuto della coppia BC al valore pre- 
sente nella coppia HL. Il risultato è in HL. 

Le istruzioni ADC e SBC significano somma con riporto e sottrazione con 
riporto (dall’inglese Add e Subtract with Carry); in realtà il riporto viene 
memorizzato in uno dei bit del registro flag F. Questo bit viene posto a 
1 se un’addizione ha dato un risultato troppo grande per essere caricato 
nell’accumulatore oppure se in una sottrazione è necessario l’uso del riporto. 
Quando viene eseguita una ADC, il dato specificato più il riporto vengono 
sommati all’accumulatore. Per esempio ADC A, 4 sommerebbe 5 al valore 
contenuto nell’accumulatore, se il flag di riporto fosse a 1. 

Sono disponibili anche istruzioni per agire direttamente sul flag di riporto: 

1. CCF: il valore del bit di riporto viene invertito. 

2. SCF: il bit di riporto viene posto a 1. 

Si noti che non esiste un’operazione di sottrazione per dati su 16 bit. Ne 
consegue che non è necessario indicare esplicitamente il registro A quando 
si usa l’istruzione SUB. 

Esempio: SUB 4 decrementa l’accumulatore di 4. 



Istruzioni logiche a 8 bit 

Tutti i sei tipi di operazioni in oggetto richiedono che uno dei dati sia stato 
preventivamente caricato nell’accumulatore. Il risultato è ritornato nell’ac- 
cumulatore. 

Tre operazioni di questa categoria sono state presentate in precedenza: 

1. AND 

2. OR 

3. XOR 

Le altre tre sono: 

1. CP per confrontare 

2. CPL per ottenere il complemento a 1. 

3. NEG per ottenere il complemento a 2. 

L’istruzione CPL inverte semplicemente il valore di ogni bit nell’accumula- 
tore. Anche NEG inverte i bit, ma incrementa il risultato per ottenere il com- 
plemento a due del valore originale. 
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L’istruzione CP è invece insolita in quanto il dato viene sottratto all’accu- 
mulatore, ma il risultato non viene ritornato; il valore dell’accumualtore 
rimane invariato: in compenso viene cambiato il valore di parecchi bit del 
registro flag F; in particolare: 

1. Il bit denominato ZERO viene posto a 1 se il valore dell’accumulatore 
è uguale al dato confrontato ad esso con la CP. Per esempio CP 4 porrà 
a 1 il flag Z (ZERO) se nell’accumulatore c’è 4, altrimenti Z viene posto a 0. 

2. 11 bit di segno (S) viene posto a 1 se il dato confrontato è maggiore di 
quello contenuto nell’accumulatore. Inoltre viene posto a 1 il flag N, men- 
tre sono aggiornati i flag H, P/V e CY. 

Esempi: 

AND 128 opererà un’operazione di prodotto logico tra 10000000 (binario) 
e l’accumulatore A. 

CPL inverte i bit dell’accumulatore. 



Istruzioni di rotazione e spostamento laterale di bit 

Se i bit di un numero binario vengono spostati lateralmente di una posizio- 
ne sulla sinistra, il valore viene raddoppiato. Quindi lo spostamento latera- 
le dei bit che compongono un byte è uno dei modi con cui il processore 
è in grado di svolgere moltiplicazioni e divisioni. 

Lo Z-80 dispone di tre operazioni di spostamento e di otto per la rotazione 
di bit, ciascuna delle quali opera solo su dati di otto bit. Quando i bit di 
un byte vengono spostati lateralmente in una direzione, un bit viene perso 
e un altro viene lasciato vacante. Il bit di riporto viene usato per sostituire 
o per memorizzare il bit vacante o quello perso in dipendenza dell’istruzio- 
ne usata. 

Le otto operazioni di rotazione consistono in quattro istruzioni che agisco- 
no sull’accumulatore, e di altre quattro, funzionalmente analoghe, che agi- 
scono su una qualsiasi locazione di memoria o su un differente registro: 

1. RL e RLA: hanno la stessa funzione, solo che la seconda è un’istruzione 
dedicata all’accumulatore. Ogni bit viene spostato di una posizione a sini- 
stra. 11 bit vacante, quello meno significativo, viene riempito con il bit di 
riporto, mentre quello più significativo, che andrebbe perso, viene memo- 
rizzato nel bit di riporto stesso. 

Esempi: RL B 

RL (HL) 

RLA 
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2. RR e RRA: analoghe a RL e RLA, tranne che la rotazione viene effet- 
tuata verso destra. 

Esempi: RRH 

RR (HL) 

RRA 

3. Rii: e RLCA: in questo caso il bit più significativo viene posto sia nel 
bit di riporto sia nel bit meno significativo, lasciato vacante: 

Esempi: RLC (HL) 

RLC A 
RLCA 

Si noti che sia RLC A sia RLCA effettuano la medesima operazione. Però, 
come gran parte delle operazioni, provocano delle modifiche in molti dei 
bit del registro flag F; RLC A e RLCA non modificano gli stessi flag. 

4. RRC e RRCA: analoghe a RLC e RLCA, con rotazione verso destra. 
Le tre operazioni per lo spostamento laterale dei bit sono: 

1. SLA: spostamento a sinistra “aritmetico”. 

Ciascun bit viene spostato a sinistra; il bit più significativo viene messo 
nel bit di riporto mentre quello meno significativo è posto a 0. 

Esempi: SLA A 

SLA (HL) 

2. SRL: spostamento a destra “logico”. 

Ciascun bit viene spostato a destra, quello meno significativo viene messo 
nel bit di riporto e il più significativo viene posto a 0. 

Esempio: SRL D 

3. SRA: spostamento a destra “aritmetico”. 

Si tratta di un vero e proprio spostamento aritmetico in quanto il bit più 
significativo (quello che indica il segno) non viene modificato. Il byte vie- 
ne spostato a sinistra di una posizione e il bit meno significativo viene messo 
nel bit di riporto. 

Esempi: SRA A 

SRA (HL) 

Vi sono inoltre due istruzioni, RLD e RRD per operandi in decimale codi- 
ficato in binario (B.C.D. = binary-coded decimai). 



Istruzioni sui bit 

Ne esistono due, SET e RES, che pongono rispettivamente a 1 e a 0 il bit 
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di cui viene specificata la posizione. 

Esempio: SET 4,A pone a 1 il quarto bit dell’accumulatore. 

RES 6, (HL) pone a 0 il sesto bit del byte il cui indirizzo si tro- 
va nella coppia di registri HL. 

L’istruzione BIT viene usata per controllare il valore di un bit in un registro 
o in una locazione di memoria. Il flag Z viene impostato con un valore 
inverso rispetto a quello del bit specificato, che non viene alterato. 



Istruzioni di salto e di sottoprogramma 

Sei dei bit del registro flag F vengono effettivamente utilizzati; gli altri due 
sono vacanti: 



H 



N CY 



* t t f 

| 1 Riporto 

Somma/sottrazione 
Parità/overflow 
Metà riporto 



Zero 
Segno 



Fig. 4.7 - Il registro flag F 



Molte delle operazioni svolte dallo Z-80 modificano, ponendoli di volta in 
volta a 0 o a 1, alcuni di questi flag in dipendenza del risultato dell’opera- 
zione stessa. 

Il flag del segno S è una copia del bit piu significativo del risultato. Viene 
posto a 1 quando si presenta un valore negativo (in complemento a due). 
Il flag Z viene posto a 1 solo quando il risultato è uguale a zero. Se nell’ap- 
pendice D viene specificato che una delle operazioni modifica il flag Z, 
ne consegue che un risultato diverso da zero ne provoca l’azzeramento. 

I flag di “metà riporto” e di “somma/sottrazione” vengono usati nelle ope- 
razioni tra valori in B.C.D. e sono di scarso interesse per i programmatori 
non specializzati. 

II flag di “parità/overflow” è insolito nel senso che viene posto a 1 o a 0 
da certe istruzioni in accordo con un certo criterio, mentre altre istruzioni 
usano un criterio differente. 

Se il flag viene modificato secondo la parità del risultato, esso viene posto 
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a 0 se il numero di 1 contenuti nel risultato stesso è dispari, altrimenti vie- 
ne posto a 1. Usato come flag di overflow, esso viene posto a 1 se un’opera- 
zione di addizione o di sottrazione provoca una modifica erronea del bit 
7. Nella rappresentazione binaria con segno tutti i valori negativi hanno 
il bit più significativo posto a 1. Un risultato fuori dall’intervallo di validi- 
tà provoca un’inversione non voluta di questo bit. Il flag di overflow con- 
sente di accorgersi di una tale situazione. 

Come abbiamo accennato in precedenza, il registro flag viene usato nelle 
istruzioni di salto condizionato. Se un particolare flag è posto a 0 o vice- 
versa a 1, allora il salto viene effettuato; contrariamente il programma con- 
tinua dall’istruzione successiva. 

Le due principali istruzioni di salto sono JR (Jump Relative) e JP (JumP). 
Entrambe possono essere condizionate. L’istruzione JR viene accompagnata 
da un byte di spiazzamento il cui valore indica quanti byte devono essere 
saltati a partire dall’indirizzo contenuto nel contatore di istruzioni del pro- 
gramma. Lo spiazzamento può essere al massimo di 127 byte in avanti e 
128 indietro. In caso di spiazzamento negativo, viene usata la rappresenta- 
zione in complemento a due. 

Esempi: JP 40000 forza un salto alla locazione 40000 caricando semplice- 
mente questo indirizzo nel contatore delle istruzioni del programma. JR 
— 120 modifica il suddetto contatore in modo che, rispetto all’indirizzo della 
istruzione che sarebbe stata eseguita immediatamente dopo, esso punti 120 
byte più indietro. 

I codici di condizione che possono essere usati con entrambi i tipi di istru- 
zione sono: 

1. Z e NZ: JP Z, 40000 esegue il salto alla locazione solo se Z è posto 
a 1. JR NZ,20 provoca il salto relativo solo se il bit Z del registro F è posto 
a 0. 

2. C e NC: il salto viene eseguito se, rispettivamente, il bit di riporto è po- 
sto a 1 o a 0. L’istruzione JR può usare solo i codici di condizione Z, NZ, 
C e NC. 

3. PO e PE: il salto viene effettuato se, rispettivamente, il bit di parità/over- 
flow è posto a 1 o a 0. Questo codice di condizione può essere usato sola- 
mente dall’istruzione JP. 

4. P e M: anche questi codici condizionali possono essere usati solo da JP 
e fanno in modo che il salto venga eseguito se, rispettivamente il bit S di 
segno del registro F è posto a 0 o a 1. 

Esempi: JP P, 22000 effettua un salto alla locazione 22000 se il flag dì se- 
gno è posto a 0. JP PO, 12000 invece effettua il salto solo nel caso sia posto 
a 1 il bit di parità/overflow. 

Un’ultima istruzione di salto è la DJNZ che decrementa il contenuto del 
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registro B ed effettua il salto se il valore in B è diverso da 0. Per esempio 
DJNZ 20. 

II flag Z può essere posto a 1 o a 0 usando l’istruzione BIT. Questa infatti 
controlla uno specifico bit in un registro o in una locazione e se questo 
bit vale 0, il flag Z viene posto a 1, e viceversa. Per esempio BIT 4,A porrà 
a 1 il flag Z se il quarto bit dell’accumulatore vale zero. 

L’attivazione di sottoprogrammai viene fatta con le istruzioni CALL e RET. 
Entrambe queste operazioni possono essere condizionate da una qualsiasi 
delle condizioni valide per la JP. 

Esempi: CALL 20000 provoca il trasferimento del controllo dell’esecuzio- 
ne al sottoprogramma che inizia all’indirizzo 20000, fino a che viene in- 
contrata un’istruzione RET. L’indirizzo di ritorno viene memorizzato sullo 
stack. Un’attivazione di sottoprogramma con condizione ha la seguente sin- 
tassi: CALL NZ.12000 mentre un ritorno condizionato può essere RET Z. 
Una variante dell’istruzione CALL è RST x, dove x deve essere un multi- 
plo di 8 compreso tra 0 e 56. Quest’istruzione effettua semplicemente una 
chiamata al sottoprogramma all’indirizzo x. 

Per esempio RST 24 effettua una chiamata all’indirizzo 24. 

Trasferimento di blocchi e operazioni di ricerca 

Ci sono quattro istruzioni di trasferimento e quattro per la ricerca. Le istru- 
zioni di trasferimento consentono di spostare blocchi di dati senza influen- 
zare il contenuto dell’accumulatore: 

1. LDIR: l’indirizzo del primo byte del blocco di dati che deve essere tra- 
sferito viene posto in HL mentre il numero di byte che lo compongono è 
posto in BC. Infine, prima che sia usata l’istruzione in oggetto, l’indirizzo 
di destinazione viene messo in DE. Ad ogni trasferimento di un byte BC 
viene decrementato e HL e DE incrementati. Il trasferimento termina quando 
BC diventa uguale a 0. 

2. LDDR: essenzialmente è un’istruzione analoga alla LDIR, solo che il 
contenuto di HL e DE viene decrementato dopo il trasferimento di ogni byte 

3. LDI: analoga a LDIR, solo che viene trasferito un solo byte. 

4. LDD: analoga a LDDR, solo che viene trasferito un solo byte. 

Esempio: per copiare un blocco di 20 byte a partire dalla locazione 12000 
nella locazione 14000. 

LD HL, 12000 
LD BC.20 
LD DE, 14000 
LDIR 
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Si potrebbe ottenere lo stesso risultato usando l’istruzione LDDR e cari- 
cando in HL 12019 ed in DE 14019. 

Le istruzioni di ricerca controllano un blocco di dati fino a quando viene 
trovato un valore uguale a quello contenuto nell’accumulatore: 

1. CP1R: la coppia BC viene caricata con la lunghezza del blocco su cui 
effettuare la ricerca e la coppia HL con l’indirizzo del primo byte del bloc- 
co stesso. Infine il termine di confronto, cioè il dato che viene verificato, 
viene posto nell’accumulatore. La ricerca termina quando BC vale zero op- 
pure quando è stato trovato un byte il cui valore corrisponde a quello con- 
tenuto nell’accumulatore. Il flag Zero indica che: 

Se posto a 1: è stata trovata corrispondenza tra l’accumulatore e un dato. 
Se posto a 0: BC è stato decrementato fino a 0. 

2. CPDR: istruzione analoga a CPIR con l’eccezione che la ricerca proce- 
de in memoria all’indietro, a partire dall’indirizzo contenuto in HL, invece 
che in avanti. 

3. CPI: del tutto simile a CPIR, solo che viene controllato un solo byte. 

4. CPD: analoga a CPDR, solo che viene controllato un solo byte. 

Si noti che in tutte le istruzioni sia di trasferimento sia di spostamento il 
flag P/V indica se il conteggio ha raggiunto lo zero: 

Se BC = 0 il P/V viene posto a zero. 

Se BC è diverso da 0, allora P/V viene posto a 1. 

Esempio: seguono le istruzioni necessarie per effettuare la ricerca di un by- 
te con valore 4 nel blocco di memoria che parte dalla locazione 42000 e 
si estende per 120 byte. 

LD BC.120 
LD HL, 42000 
LD A, 4 
CPIR 

Se al termine della ricerca il flag Z del registro F è posto a 1, allora la cop- 
pia di registri HL contiene l’indirizzo del byte cercato. 

Istruzioni di controllo dell’unità centrale e delle operazioni 
di ingresso/uscita 

Il gruppo di istruzioni per il controllo dell’unità centrale può essere diviso 
in quattro parti: 

1. Operazioni di scambio. 
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2. Le istruzioni NOP e HALT. 

3. Le operazioni sullo stack. 

4. Operazioni di ingresso/uscita e di interruzione. 

1. Operazioni di scambio 

Per effettuare degli scambi di valori esistono due istruzioni. La EXX scambia 
il contenuto di tre coppie di registri, la BC, DE e HL, con quelle equiva- 
lenti alternative, BC’, DE’ e HL’. La seconda istruzione, la EX, scambia sem- 
plicemente i valori contenuti in due registri a 16 bit. Quest’ultima ha quat- 
tro varianti: 

L 

1. EX AF,AF’.. scambia i registri A ed F con i registri alternativi A’ ed F’. 

ii. EX DE,HL .. scambia il valore della coppia DE con quello della coppia 
HL. 

iii. EX (SP),IY e EX (SP), IX .. scambia il registro indice con i due byte 
che si trovano sulla cima dello stack. 

iv. EX (SP), HL .. analogo al caso iii, tranne che ora è la coppia HL che 
prende il posto del registro indice. 

2. Le istruzioni NOP e HALT 

L’istruzione NOP (NO oPeration) non fa nulla per un periodo di 4 cicli 
macchina. Viene spesso usata per sostituire il codice ridondante o per riem- 
pire un’area richiesta per una futura espansione. 

L’operazione HALT costringe il processore ad eseguire continuamente l’i- 
struzione NOP fino a quando non si verifica un’interruzione o una rinizia- 
lizzazione generale. Le NOP vengono effettuate per consentire allo Z-80 
di aggiornare di continuo la memoria RAM. Infatti il registro che control- 
la quest’operazione viene automaticamente incrementato dopo che ogni istru- 
zione è stata estratta dalla memoria per essere eseguita. Il valore che esso 
contiene rappresenta il byte meno significativo della sezione di memoria 
che deve essere aggiornata. 

3. Operazioni sullo stack 

Tutte le operazioni che concernono lo stack agiscono su dati a 16 bit. 11 
contenuto di ciascuna coppia di registri può essere messo sulla cima dello 
stack (PUSH) o viceversa caricato (POP) a partire dai due byte che si tro- 
vano in cima allo stack. La prima operazione non altera ovviamente il con- 
tenuto dei registri. 

Dopo che l’operazione è stata completata, il registro puntatore allo stack 
contiene l’indirizzo del byte che si trova in cima allo stack. Quindi se il pun- 
tatore allo stack contiene X, il byte più significativo dell’ultima coppia di 
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registri messa sullo stack si trova all’indirizzo X — 1; quello meno signifi- 
cativo all’indirizzo X. 

Esempi: 



PUSH BC, POP BC, PUSH IY, POP IY 



11 registro puntatore allo stack può essere accessibile direttamente usando 
le istruzioni LD, INC e DEC. 

Esempio: INC SP:INC SP incrementerà il suddetto registro di due locazio- 
ni. Poiché lo stack si estende in memoria all’indietro, si sono persi i 16 bit 
che si trovavano sulla cima dello stack. 



4. Operazioni di ingresso/uscita e di interruzione 

Un’interruzione si verifica quando una componente esterna interrompe la 
normale attività esecutiva del processore. L’interruzione può essere provo- 
cata tramite una delle quattro linee di controllo dello Z-80: 

1. BUSRQ 

2. RESET 

3. NMI 

4. INT 



Le linee 1, 2 e 3 sono raramente, anzi quasi mai, usate dal programmatore. 
La linea di BUSRQ, presentata in precedenza in questo capitolo, consente 
ad un altro processore di accedere al bus dati ed indirizzi del sistema. RE- 
SET viene usata per inizializzare il sistema al momento dell’accensione. I 
registri I ed R sono posti a zero prima che inizi l’esecuzione del program- 
ma a partire dalla locazione 0. 

L’interruzione non mascherabile (NMI, dall’inglese Non Maskable Inter- 
rupt) costringe il processore ad eseguire una speciale routine alla locazione 
&H66. Nella configurazione MSX questa locazione è allocata dal sistema 
operativo per operazioni su disco e di conseguenza il NMI viene raramente 
implementato. 

La linea INT può iniziare una qualsiasi di tre sequenze di operazioni. La 
scelta viene effettuata dall’utente con le istruzioni: IMO, IMI o IM2. 

In ogni caso il contenuto del registro contatore delle istruzioni del programma 
viene salvato sullo stack e viene fatto un salto alla locazione che viene in- 
dicata. Quando viene incontrata un’istruzione di RETI (RETurn from In- 
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terrupt), nel registro contatore delle istruzioni viene caricato l’indirizzo della 
locazione di ritorno e viene ripresa l’esecuzione dalla procedura che era stata 
interrotta. 

La condizione di INT viene controllata dopo l’esecuzione di ogni istruzio- 
ne. Tale condizione non è basata sul cambiamento di stato di una linea ma 
sul suo livello. Ne consegue che, a meno di voler attivare un’altra condizio- 
ne di interruzione, il dispositivo da cui viene generata l’interruzione non 
deve continuare a tenere basso il livello della linea. 

Il processore ha due circuiti bistabili (flip-flop) interni che caratterizzano 
il processo d’interruzione: IFF1 e 1FF2. Se IFF1 è posto a 0, ogni richiesta 
di INT viene ignorata dal processore. Se viceversa è posto a 1, sono abilita- 
te le interruzioni mascherabili. * 

Il programmatore, per mezzo delle istruzioni EI (Enable Interrupt = abili- 
ta le interruzioni) e DI (Disable Interrupt = disabilita le interruzioni), può 
porre a 1 o a zero sia IFF1 sia IFF2. IFF2 viene usato per memorizzare 
IFF1 durante un’interruzione non mascheratole, quando IFF1 è posto a uno 
per disabilitare ogni richiesta da INT. 

L’indirizzo della procedura che deve essere seguita per “servire” l’interru- 
zione viene indicato in modo differente per ciascuno dei modi della INT: 



Modo 0: Abilitato dall’istruzione IMO 

1. Sia IFF1 sia IFF2 sono poste logicamente a 0. Questo evita ogni proble- 
ma di rientranza. 

2. Lo Z-80 segnala la ricezione dell’interruzione al prossimo ciclo macchi- 
na tenendo basse due linee: IORQ e MI. 

3. La componente che ha generato l’interruzione pone un codice operativo 
di un byte sul bus dati. Questo codice può essere sia una RST che una 
CALL.. 

4. Se viene indicato un codice operativo di RST, il contenuto del registro 
contatore di istruzioni del programma viene posto sullo stack e si esegue 
un salto alla locazione specificata nella pagina zero. 

5. Dopo un codice operativo di chiamata, la componente da cui “sorge” 
l’interruzione deve porre altri due byte sul bus dati. Essi indicano l’indiriz- 
zo della routine che deve essere eseguita: l’esecuzione effettiva inizia dopo 
il salvataggio sullo^stack del PC (program counter, vale a dire il registro 
contatore delle istruzioni del programma). 

6. Quando viene incontrata un’istruzione di RETI, i due byte che si trova- 
no sulla cima dello stack vengono caricati nuovamente nel PC. La RETI 
non pone a 1 il IFF1 e quindi le interruzioni devono essere riabilitate da 
una EI. 
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Si noti che deve essere usata anche un’istruzione di RET per assicurare una 
corretta ripresa della procedura la cui esecuzione era stata interrotta. Ciò 
nonostante certe componenti sono in grado di accorgersi quando lo Z-80 
ha caricato per l’esecuzione un’istruzione di RETI. Questa capacità può 
essere sfruttata per rimuovere la richiesta iniziale di interruzione. 

Modo 1: Abilitato dall'istruzione IM 1 

La sequenza di inizializzazione che viene compiuta all’accensione da un ela- 
boratore MSX seleziona questa modalità. La sequenza eseguita dopo una 
richiesta accettata di interruzione è la seguente: 

1. IFF1 ed IFF2 vengono posti a zero. 

2. Il contenuto del PC viene messo sullo stack. 

3. L’esecuzione prosegue dalla locazione &H38. 

4. Quando viene incontrata un’istruzione di RETI, i due byte di cima dello 
stack vengono rimessi nel registro contatore delle istruzioni, e viene quindi 
ripresa l’esecuzione del programma che era stato interrotto. 

Si noti che per riabilitare le interruzioni mascherabili, è necessario porre 
a 1 IFF1 per mezzo dell’istruzione EI. 

Modo 2: Abilitato dall’istruzione IM 2 

La modalità 2 è la più flessibile delle tre consentite dalla INT. Permette 
infatti alla componente che genera l’interruzione l’accesso a 128 diverse pro- 
cedure di gestione dell’interruzione stessa. Dopo che l’interruzione è stata 
ricevuta dal processore, la componente pone un solo byte sul bus dati. Questo 
viene unito al byte che si trova nel registro I in modo da formare un indi- 
rizzo su 16 bit: 

Byte registro I / byte della componente 
bbbbbbbbbbbbbbbb 

Il puntatore su due byte indica quindi l’indirizzo della routine che deve es- 
sere eseguita.: 

Indirizzo su 16 bit: 



Puntatore su 16 bit 
alla routine di gestione 
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La sequenza eseguita è: 

1. IFF1 viene posto a zero. 

2. Lo Z-80 comunica la ricezione dell’interruzione tramite le linee IORQ 
e MI. 

3. La componente che genera l’interruzione mette un byte sul bus dati. 

4. L’indirizzo corrente contenuto nel registro PC viene posto sullo stack. 

5. Viene eseguita la procedura di gestione che si trova all’indirizzo calcola- 
to come visto sopra. 

6. Quando viene incontrata una RETI, viene ripristinato il PC con i due 
byte in cima allo stack, e viene ripresa l’esecuzione del programma interrotto. 



Istruzioni di ingresso/uscita 

In questo gruppo sono compresi due sottoinsiemi di istruzioni per effet- 
tuare operazioni di ingresso o di uscita da e su porte di 8 bit. 

1. Ingresso/uscita di un solo byte 

Le due istruzioni sono IN e OUT: ciascuna ha due formati possibili, il pri- 
mo dei quali può usare solamente il registro A, mentre il secondo può far 
uso di uno dei seguenti registri: A, B, C, D, E, 'H o L. 

Se si usa il formato particolare dell’accumulatore, la porta deve essere indi- 
cata tra parentesi: IN A, (porta). Nel secondo formato invece viene usato 
il registro C per selezionare la porta: OUT (C), registro. 

Abbiamo già discusso in breve i meccanismi che regolano le operazioni di 
ingresso/uscita nella prima parte del capitolo. Lo Z-80 scrive il numero della 
porta sugli otto bit meno significativi del bus indirizzi prima di porre il 
dato sul bus dati. 

Si noti però che sia nella istruzione IN A, (porta) che in OUT (porta), A, 
il processore scrive il contenuto dell’accumulatore sulle linee dalla A15 alla 
A8. In modo analogo le istruzioni IN registro,(C) e OUT (C), registro im- 
plicano la scrittura del registro B sulle linee di indirizzo superiore. Ciò con- 
sente di utilizzare più di 256 porte, a patto di disporre del necessario hard- 
ware di decodifica. 

2. Istruzioni di ingresso/uscita per blocchi di dati 

I blocchi di dati possono essere formati da un minimo di un byte fino a 
un massimo di 256 byte. In questo gruppo di istruzioni ci sono quattro coppie 
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di codici operativi, in modo analogo a quanto accade per i gruppi di istru- 
zioni di trasferimento e di ricerca: 

i. INIR e OT1R: i dati di inizializzazione richiesti sono: 

a. il numero della porta nel registro C. 

b. l’indirizzo del primo dato in HL. 

c. la dimensione del blocco nel registro B. 

La coppia di registri HL viene incrementata dopo ogni trasferimento. Se 
il registro B è stato decrementato fino a zero, viene posto a I il flag Z. 

ii. INDR e OTDR: analoghe alle due precedenti, con la sola differenza che 
HL viene decrementato dopo ogni trasferimento. 

iii. INI e OLITI: analoghe alle istruzioni INIR e OTIR, solo che provocano 
l’ingresso o l’uscita di un solo byte. HL viene incrementato mentre B viene 
decrementato. 

iv. IND e OUTD: analoghe a INI ed a OUTI, ad eccezione del fatto che 
la coppia HL viene decrementata ad ogni trasferimento. 



Modalità d’indirizzamento 

Come abbiamo avuto modo di vedere, ciascun codice operativo consente 
di specificare in diversi modi l’indirizzo del dato su cui si deve operare. Ben- 
ché lo Z-80 abbia dieci diverse modalità d’indirizzamento, non è necessa- 
rio che ogni tipo d’istruzione abbia una variante per ciascuna delle moda- 
lità. Il lettore troverà autoesplicativa la maggior parte dei formati - molti 
dei quali sono già stati presentati: 

1. Implicito: Non viene specificato alcun indirizzo, in quanto è implicito 
nell’istruzione. 

Esempio: NEG. 

2. Immediato: Viene specificato, invece dell’indirizzo, il dato corrente, su 
8 bit. 

Esempio: LD A, 2 

3. Immediato esteso: Viene specificato, invece dell’indirizzo, il dato cor- 
rente, su 16 bit. 

Esempio: LD HL, 20000 
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4. Relativo: Questa modalità viene usata solamente dall’istruzione di salto 
relativo e da DJNZ. Il byte che segue il codice operativo ha un valore con 
segno compreso tra — 128 e 127. Questo indica lo spiazzamento che deve 
essere sommato all’indirizzo contenuto nel contatore di istruzioni del pro- 
gramma per ottenere l’indirizzo della prossima istruzione che deve essere 
eseguita. 

Esempio: JR 20 

5. Registro: Il dato su cui operare è contenuto nel registro che viene speci- 
ficato. 

Esempio: LD A,B 

6. Registro indiretto: Un registro indice o una coppia di registri contengo- 
no l’indirizzo del dato su cui operare. Il registro o la coppia di registri ven- 
gono indicati tra parentesi. 

Esempio: LD A,(DE) 

7. Esteso: L’indirizzo del dato viene indicato tra parentesi. 

Esempio: LD A,(4000) 

8. Indiciato: Si tratta di una forma essenzialmente analoga a quella “regi- 
stro indiretto, con l’aggiunta di uno spiazzamento che deve essere aggiunto 
al valore contenuto dal registro indice: 

Esempio: LD A,(IY+5) 

9. Pagina zero modificata: Solo la RST usa questa modalità. Viene effet- 
tuata una chiamata alla locazione specificata. Quest’ultima deve essere un 
multiplo di 8 compreso tra 0 e 56. 

Esempio: RST 8 

10. Bit: La modalità bit è insolita in quanto non viene specificato un byte, 
bensì un bit. Viene usata da tre tipi di istruzioni: BIT, SET e RES. I bit 
sono numerati come segue: 

xxxxx r xxx 

7 6 5 4 3 2 1 0 

Esempio: SET 4, A 

Si è così arrivati al momento in cui i lettori possono provare a scrivere loro 
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stessi delle routine in linguaggio macchina. I seguenti consigli potranno di- 
mostrarsi utili a tale proposito; 

1. Salvate sempre un programma scritto in codice macchina prima di pro- 
varne il funzionamento. Potrebbe infatti contenere un errore: in tal caso 
la macchina si bloccherebbe; sareste cosi costretti a spegnerla, perdendo 
il codice, per ripristinare la situazione. 

2. È improbabile che una routine funzioni correttamente al primo colpo. 
Se siete fortunati due o tre sue parti funzioneranno nel modo voluto: ci 
vuole pazienza. 

3. Se volete unire un codice macchina a un programma BASIC, è più sem- 
plice usare un ciclo in BASIC per caricare il codice macchina nella posizio- 
ne voluta, piuttosto che caricare separatamente i programmi per poi salvarli. 
Se i due programmi devono passarsi dei valori, è preferibile usare delle istru- 
zioni PEEK e POKE piuttosto che la funzione USR. 

4. In generale le routine scritte in linguaggio macchina richiedono una fase 
di messa a punto più lunga: vale quindi la pena di dividere i programmi 
in piccole sezioni, ciascuna delle quali viene attivata da un programma prin- 
cipale. 
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Capitolo 5 

LA CONFIGURAZIONE MSX 



La specifica di base per i sistemi MSX comprende un’unità centrale di ela- 
borazione Z-80 o equivalente, funzionante a 3.5 MHz, affiancata da un pro- 
cessore video TMS-9929A della Texas Instruments (TMS-9918A in Ameri- 
ca e Giappone) e da un integrato per la generazione di suoni AY-3-8910 della 
General Instruments. 

Oltre ai suddetti componenti il sistema prevede anche un’interfaccia pro- 
grammabile 8255 della Intel, che gestisce la scansione della tastiera e il si- 
stema di paginazione della memoria. La specifica viene poi completata dai 
32K del BASIC MSX e dalla ROM del sistema operativo e da un minimo 
di 8Kbyte di RAM utente (anche se sul mercato europeo sembra assai im- 
proponibile la vendita di una macchina con meno di 32K). Inoltre il pro- 
cessore video viene fornito di 16K di RAM dedicata al video che viene usata 
per memorizzare lo schermo, i colori e la definizione degli sprite. L’uso di 
questa ’VRAM’ verrà discussa più a fondo nel Capitolo 6. 



Gestione della memoria nell’MSX 

11 concetto di “partizione” (è un concetto logico; fisicamente viene realiz- 
zato con più banchi di memoria che trovano posto in diversi alloggiamen- 
ti, o slot) è fondamentale per la comprensione della gestione della memo- 
ria nei sistemi MSX: tale concetto verrà ora presentato in breve. 

Poiché lo Z-80 è un processore a soli 8 bit, il suo massimo spazio d’indiriz- 
zamento è di 64K byte; però il sistema MSX è stato progettato per essere 
in grado di accedere fino a 1024K byte: di conseguenza è stato adottato 
il sistema delle “partizioni”. 
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Una “partizione” è uno spazio d’indirizzamento di 64Kbyte: il sistema MSX 
può indirizzarne fino a quattro. Ciascuna di queste “partizioni primarie” 
può a sua volta essere divisa in quattro “partizioni” secondarie dando cosi 
luogo ad uno spazio indirizzatole complessivo di 4 * 4 * 64 = 1024 Kbyte. 
Ciascuna partizione (primaria o secondaria) è a sua volta divisa in quattro 
pagine di 16 Kbyte ciascuna: queste ultime sono le entità di base che il si- 
stema MSX usa per creare il suo spazio d’indirizzamento. Qualsiasi sia la 
partizione di cui si sta trattando, le quattro pagine iniziano rispettivamen- 
te agli indirizzi 0000H, 4000H, 8000H e 0C000H. Le pagine possono esse- 
re indirizzate solo ed unicamente al loro indirizzo reale (cioè pagina 0 a 
OOOOH, pagina 1 a 4000H, ecc.). In tal modo il sistema MSX può accedere 
a qualsiasi pagina di una qualsiasi partizione, ma deve comunque fare sempre 
riferimento per la pagina 0 all’indirizzo OOOOH, per la pagina 3 a 0C000H 
e così via. 

La selezione della partizione primaria viene effettuata scrivendo nella por- 
ta A dell’8255 PPI nel seguente formato: 



Bit: 76 54 32 IO 

:10:0I:t 1:00: Porta A 8225 




Partizione pagina 3 
Partizione pagina 2 




Partizione pagina 0 
Partizione pagina 1 



Poiché l’allocazione su ciascuna partizione viene descritta con 3 bit, ne con- 
segue che ogni allocazione può essere indicata numericamente con un va- 
lore compreso tra 0 e 3 (00B e 11 B), consentendo così la selezione di uno 
qualsiasi delle quattro partizioni principali per ognuna delle quattro pagi- 
ne. La selezione di una partizione secondaria si ottiene scrivendo, nello stesso 
formato, alla locazione OFFFFH deH’alloggiamento principale. Quando si 
effettua una lettura da questo indirizzo il valore ritornato è il complemen- 
to di quello reale. 

Al momento dell’accensione (partenza “a freddo”) il sistema MSX (che è 
residente nella partizione 0 che è quindi il primo ad essere accessibile dalla 
CPU) inizia una ricerca dell’area contigua di RAM più ampia a partire dal- 
l’indirizzo OFFFFH verso il basso e alloca quest’area per le pagine 3 e 2. 
In condizioni normali, quindi, non è necessario che il programmatore ef- 
fettui esplicitamente una scelta della partizione, tranne il caso di un siste- 
ma con una RAM di 64 Kbyte o più, laddove c’è sovrapposizione tra RAM 
e ROM, o nel caso di un software basato su cartuccia che è stato scritto 
per essere eseguito in partizioni diverse da 0. 



108 




Metodi di accesso al generatore di suoni, al VDP e alla PPI 

Lo Z-80, oltre a poter indirizzare 64 Kbyte di memòria, può anche accede- 
re agli indirizzi di 256 porte di ingresso/uscita. Questi ultimi vengono uti- 
lizzati per accedere al VDP e alle altre componenti del sistema (comprese 
l’interfaccia RS-232 e le altre espansioni previste). Però, per permettere even- 
tuali modifiche hardware, le chiamate al BIOS (Basic I/O System = siste- 
ma di base per l’ingresso/uscita) vengono fornite nella ROM del sistema 
MSX. Questo consente di accedere alle componenti del sistema in modo 
tale che se in una unità MSX un integrato occupa una posizione differente, 
ciò viene compensato dal firmware. La differenza è quindi invisibile da parte 
del programmatore e viene così assicurata una completa compatibilità soft- 
ware. L’unica eccezione a questa regola è il VDP (il processore video), che 
sarà preso in seguito approfonditamente in esame. 

Introduzione generale al processore video 

Il processore video TMS-9929A della Texas Instruments è a sua volta un 
microprocessore. Esso è responsabile dell’intera gestione del video ed acce- 
de a 16K di RAM video dedicata. In quest’ultima sono contenute le defini- 
zioni dei caratteri, i dati di schermo, i dati di colore, la definizione degli 
sprite e i loro attributi. In tal modo la RAM di sistema è libera di essere 
usata per la programmazione (quel che si perde è una parte della velocità 
per accedere alla RAM video). In circostanze normali, però, questa ridu- 
zione non è critica. In situazioni critiche, viceversa, esiste la possibilità di 
intervenire con vari “trucchi”, che verranno discussi nel Capitolo 6. 

Il VDP ha quattro modalità di visualizzazione: Grafica I, Grafica II, Mul- 
ticolore e Testo. La modalità testo fornisce 24 righe di 40 colonne con due 
colori ed è stata progettata per massimizzare le capacità di visualizzazione 
sui video dei televisori domestici. La modalità multicolore fornisce un vi- 
deo di 64 * 48 punti con 15 colori più il trasparente. La modalità Grafica I 
fornice un video da 256 * 192 pixel per la generazione di grafici in 15 colori 
più il trasparente. La modalità Grafica II è un miglioramento della Grafica 

I in quanto consente di ottenere colori e figure più complesse. 

II display video consiste di 34 piani che devono essere considerati come so- 
vrapposti in profondità. Quello più interno è il piano dello sfondo, quello 
successivo è il pianò su cui agiscono le modalità Grafica I e II, mentre i 
restanti sono i 32 piani riservati agli sprite. 

Oltre a gestire il video, il VDP si occupa del “refresh” della memoria RAM 
utente ed effettua una richiesta d’interruzione ogni 20 ms. Per avere ulte- 
riori dettagli sul VDP e sulla sua programmazione fate riferimento al Ca- 
pitolo 6. 
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Il generatore di suoni General Instruments AY-3-8910 

Il Gl AY-3-8910 è un integrato per la generazione di suoni, a tre voci con 
un estensione di otto ottave; comprende anche un semplice controllo hard- 
ware della curva di volume ed è in grado di unire un rumore “bianco” a 
ciascuna delle tre voci. L’integrato comprende inoltre due porte di ingres- 
so/uscita che vengono sfruttate dal sistema per i joystick e le tavolette tat- 
tili. Per una descrizione delle modalità di programmazione di questa com- 
ponente si faccia riferimento al Capitolo 7. 

La PPI Intel 8255 

11 PPI Intel 8255 è un integrato per l’I/O potente e d’utilizzo generale che, 
nel sistema MSX, viene usato per diversi scopi. È sua responsabilità la ge- 
stione della tastiera (comprese quelle di estensione), varie funzioni di in- 
gresso/uscita per le cassette, il sistema di gestione della memoria e fornisce 
una porta sonora di 1 bit. 

Per una descrizione più completa dell’integrato e dei suoi vari usi si faccia 
riferimento al Capitolo 8. 



La gestione delle interruzioni e gli “agganci” della RAM 

Molte procedure che si trovano nella ROM dell’MSX vengono ridirette per 
mezzo di “agganci” nella RAM. Un “aggancio” consiste in 5 byte di RAM 
inizializzati in modo da contenere un’istruzione RET dello Z-80 (0C9H). 
La ridirezione viene effettuata dalla procedura in questione, che si trova 
in ROM, per mezzo di una chiamata (CALL dello Z-80) riferita all’aggan- 
cio. Diventa quindi semplice ridirigere la chiamata inserendo un’istruzione 
Z-80 di “JP nnnn” nei primi tre byte dell’“aggancio”. 

Il sistema MSX funziona secondo la modalità 1 d’interruzione e rende di- 
sponibili due “agganci” per la gestione delle IRQ (richieste d’interruzione). 
Il primo di questi si trova alla locazione 0FD9AH e consente di gestire del- 
le richieste d’interruzione che vengono originate da dispositivi diversi dal 
temporizzatore del VDP. Nella versione di base dell’MSX questo “aggan- 
cio” è di scarso utilizzo, ma è stato previsto per future espansioni. Il secon- 
do è alla locazione 0FD9FH e viene usato per la gestione delle interruzioni 
generate dal segnale di sincronismo video del VDP: si tratta dell’unica in- 
terruzione disponibile nel sistema di base. L’interruzione del VDP infatti 
gestisce anche la scansione della tastiera e varie altre funzioni del sistema 
operativo. È essenziale, a questo proposito, che una qualsiasi procedura uten- 
te restituisca il controllo alla routine di sistema operativo che l’aveva atti- 
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vata: in tal modo viene mantenuta una corretta gestione dell’interruzione 
in questione. 

11 sistema operativo salva tutti i registri (compresi quelli alternativi) sullo 
stack prima di effettuare la chiamata alla locazione 0FD9FH: quindi tutti 
i registri possono essere utilizzati senza preoccupazione alcuna. Però il si- 
stema operativo porta anche nell’accumulatore il contenuto del registro di 
stato del VDP prima di chiamare l’“aggancio” ed è quindi essenziale che 
nessuna routine modifichi la coppia di registri AF. Al ritorno dall’“aggan- 
cio” il sistema operativo memorizza il valore dell’accumulatore all’indiriz- 
zo OF3E7H: quando si debba testare uno dei bit del registro di stato del 
VDP all’interno di una procedura utente non attivata da interruzione, è pre- 
feribile leggere questa locazione piuttosto che il registro di stato del VDP 
direttamente. 

Oltre agli agganci di cui si è detto, il sistema ne fornisce un altro all’indiriz- 
zo 0FDD6H per la gestione delle interruzioni non mascherabili (NMI). Ciò 
è però apparentemente di scarsa utilità, in quanto da un lato il sistema di 
base non prevede nessuna interruzione non mascherabile e dall’altro per- 
ché nel sistema di gestione del disco il vettore d’entrata associato alle NMI, 
all’indirizzo 66H, è occupato dal blocco di controllo del file per il DOS. 
Nelle applicazioni utente l’uso di NMI può rivelarsi necessario e quindi l’ag- 
gancio in questione viene reso disponibile per aumentare la flessibilità ge- 
nerale del sistema. 

Il seguente programma realizza un temporizzatore in tempo reale attivabi- 
le tramite un’interruzione: esso costituisce un esempio di gestione delle ri- 
chieste d’interruzione (IRQ) da parte dell’utente. 



Esempio di temporizzatore in tempo reale 



WRTVDP EQU 47H 
RDVRM EQU 4AH 
WRTVRM EQU 4DH 
FILVRM EQU 56H 
LD1RVM EQU 5CH 
LDIRMV EQU 59H 
CHGÉT EQU 9FH 
CHPUT EQU 0A2H 
GTSTCK EQU 0D5H 
GTTRIG EQU 0D8H 
RDVDP EQU 13EH 
SNSMAT EQU 141H 



;CHIAMA LA TABELLA DEI BIOS 



; FI N E DELLA TABELLA DEI BIOS 
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VDPRGS EQU 0F3DFH 

BASNOS EQU 0F3B3H 

INTHOK EQU 0FD9FH 
ORG 0E000H 
START: LD HL.MESS 



MPLP: LD A.(HL) 

CP T 
JR Z.GETIN 
CALL CHPUT 
INC HL 
JR MPLP 

GETIN: LD HL, HHMMSS 

LD B,3 

GTINOL: CALL GETNUM 

LD (HL),A 

GTINIL: CALL CHGET 

CP 

JR NZ, GTINIL 
INC HL 

DJNZ GTINOL 
LD A.LOW CLOCK 
LD (INTHOK + 1), A 
LD A,HIGH CLOCK 
LD (INTHOK + 2),A 
LD A.0C3H 
LD(INTHOK),A 
RET 

GETNUM: CALL CHGET 
CP'O’ 

JR C.GETNUM 
CP 

CALL CHPUT 
SUB ’0' 

SLA A 
SLA A 
SLA A 
SLA A 



L’AREA DI SALVATAGGIO MSX 
PER I REGISTRI VDP 
INIZIO AREA PER LE TABELLE 
VDP 



; POSIZIONA HL AL PUNTO 
;DI INPUT 



iPRONTO PER LA STAMPA 



PRENDE 2 SEMIBYTE NUMERICI 
MEMORIZZA IN HHMMSS 
PRENDE I CARATTERI 
È IL SEPARATORE ? 

SE NO PROVA ANCORA 
PUNTA AL DATO SUCCESSIVO 
IN HHMMSS 
LO FA TRE VOLTE 
SET UP... 

INDIRIZZO DI JP 



; = ’JP'DI Z80 

;AL BASIC, AVENDO RIDIRETTO 

; L’AGGANCIO 

;PRENDE UN CARATTERE 



È NUMERICO? 

LO STAMPA 

LO CONVERTE IN NUMERICO 



;MOLTIPLICA PER 16 
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LD B,A 

GTNUM1: CALL CHGET 
CP'O' 

JR CGETNUM1 
CP 

JR NC.GETNUM1 
CALL CHPUT 
SUB ’O' 

ADD A,B 
RET 

MESS: DEFB ’ENTER TIME 

HHMMSS: DEFB 0,0,0 

CTR: DEFB 0 

CLOCK: PUSH AF 

LD A, (CTR) 

DEC A 
LD (CTR), A 
JP P.OUT 
LD A, 49 
LD (CTR), A 
LD IX, HHMMSS 
LD A,(IX + 2) 

INC A 
DAA 

LD (IX + 2),A 
CP 60H 
JR NZ.CLKPNT 
XOR A 
LD (IX + 2),A 
LD A,(IX + 1) 

INC A 
DAA 

LD (IX + 1),A 
CP 60H 
JR NZ.CLKPNT 
XOR A 
LD (IX+‘1),A 
LD A,(IX + 0) 

INC A 
DAA 

LD (IX + 0),A 
CP 24H 



;LO METTE IN B 
;PRENDE UN CARATTERE 



È NUMERICO? 

SE NON ANCORA PROVATO 
LO STAMPA 

LO CONVERTE IN NUMERICO 
LO SOMMA A B 
RITORNA COL NUMERO IN A 
MM:SS:$' 



CONSERVA LO STATO DEL VDP 



;ATTIVA L'OROLOGIO OGNI 50 MS 
JNTERRUZIONE 

;RIPOSIZIONA IL CONTATORE 



JNCREMENTA I SECONDI 



;SE NECESSARIO. . 
;RIPOSIZIONA I SECONDI 



;ED INCREMENTA I MINUTI 



;SE NECESSARIO... 
;RIPOSIZIONA I MINUTI 



;ED INCREMENTA LE ORE 



HH 
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CLKPNT: 



GNAMTB: 



JR NZ, CLKPNT 
XOR A 
LD (IX + 0),A 
LD HL.VDPRGS 
LD A,(HL) 

LD DE, 10 

AND 2 

JR NZ, GNAMTB 
INC HL 

LD A,(HL) 

AND 8 
JP NZ,OUT 
LD A,(HL) 

AND 16 
LD DE,0 
JR NZ.NGAMTB 
LD DE, 5 
LD IX.BASNOS 
ADD IX, DE 
LD L,(IX + 0) 



;ROUTINE PER STAMPARE 

;OROLOGIO AGGIORNATO 

;LEGGE COPIE NELLA RAM 

;DI SISTEMA 

;DEI REGISTRI A SOLA 

;SCRITTURA 

;DEL VDP. 

;PER TROVARE LA MODALITÀ 
; DELLO SCHERMO 
;E CALCOLARE L’OFFSET... 
PARTENDO DALLA BASE (N)... 
'TABELLA VARIABILE. 

;PER TROVARE L’INDIRIZZO 
;DI BASE 

;DELLA TABELLA DEI NOMI. 



; RICAVA L’INDIRIZZO DELLA 
TABELLA DEI NOMI 



LD H,(IX+1) 

LD DE.24 
ADD HL,DE 
LD IX.HHMMSS 
LD A,(IX + 0) 

CALL NPNT 
LD A,':' 

CALL WRTVRM 
INC HL 

LD A,(IX + 1) 
CALL NPNT 
LD A/:’ 

CALL WRTVRM 
INC HL 
LD A,(IX + 2) 



;ED AGGIUNGE 24(OFFSET) 

;DÀ L’INDIRIZZO DEL TEMPO 
;DÀ IL VALORE PRINCIPALE 
;(ORE) 

;LO STAMPA 
;CARICA I DUE PUNTI 
;LI STAMPA 

JNCREMENTA LA POSIZIONE 

;DI STAMPA 

;RIPETE PER I MINUTI 



;E PER I SECONDI 




CALL NPNT 
OUT: POP AF 

RET 

NPNT: PUSH AF 

SRL A 



SRL A 
SRL A 
SRL A 
ADD A.30H 
CALL WRTVRM 
INC HL 

POP AF 

AND 15 
ADD A,30H 
CALL WRTVRM 
INC HL 

RET 

END 



RIPORTA VDP ALLO STATO 
INIZIALE E RITORNA 
ALLA ROUTINE OS 
SALVA IL VALORE NUMERICO 
CONSIDERA IL SEMI-BYTE 
DI TESTA 



CONVERTE IN CODICE ASCII 
LO STAMPA 

INCREMENTA LA POSIZIONE 
DI STAMPA 

RIPRISTINA IL VALORE 
NUMERICO 

CONSIDERA LALTRO SEMI BYTE 
CONVERTE IN CODICE ASCII 
LO STAMPA 

INCREMENTA LA POSIZIONE 
DI STAMPA 



Uso della RAM di sistema dell’MSX 

Nel sistema MSX le locazioni da 0F380H a OFFFFH sono usate dal 
BASIC e dal sistema operativo per svolgere varie funzioni di gestione ge- 
nerale. Alcune di queste locazioni particolarmente utili a chi programma 
nel linguaggio Assembly verranno descritte in seguito. 

Le procedura di lettura e scrittura da una partizione all’altra e le routine 
di chiamata vengono fornite all’inizio della RAM di sistema. 
All’indirizzo 0F380H inizia una routine che consente di leggere da una qual- 
siasi delle partizioni primarie. Quest’ultima ha in ingresso un valore per 
la selezione della partizione (nel formato richiesto dal 8255) che deve esse- 
re posto nell’accumulatore; nel registro D viene posto il vecchio valore del- 
lo stato della partizione e nella coppia HL viene posto l’indirizzo. La rou- 
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tine ritorna il valore letto nel registro E, lasciando invariati tutti i rimanen- 
ti registri. 

Una routine analoga a quella appena descritta inizia all’indirizzo OF385H: 
essa agisce con le medesime convenzioni sul contenuto dei registri, ma ef- 
fettua una scrittura del valore contenuto in E. 

Infine la routine che si trova in OF38CH effettua chiamate da una partizio- 
ne all’altra. Questa procedura si aspetta di trovare sullo stack il vecchio va- 
lore di stato della partizione e quello nuovo nell’accumulatore; inoltre un 
valore che debba essere passato deve essere nella coppia di registri alterna- 
tivi AF, e ancora l’indirizzo a cui fare la chiamata in IX. Ogni valore ritor- 
nato dovrà essere messo nella coppia di registri alternativi AF. 

11 sistema memorizza gli indirizzi di chiamata per la funzione USR del 
BASIC nelle locazioni dalla 0F39AH alla 0F3ADH ordinatamente dalla 
USRO fino alla USR9, allocando due byte per ciascuna. Le locazioni dalla 
OF3B3H alla 0F3D9H contengono i valori che vengono messi in corrispon- 
denza alla pseudovariabile BASE(N) del BASIC, predisponendo due byte 
per ciascun valore. 

Nella locazione 0F3DBH viene memorizzata l’opzione “key click” (attivando 
la quale si ottiene un piccolo segnale sonoro quando si premono i tasti): 
scrivendo 0 in questo indirizzo l’opzione viene disabilitata; viceversa per 
un valore diverso da zero. 

La posizione, in coordinate xy, del cursore sullo schermo viene memoriz- 
zata agli indirizzi 0F3DCH (Y) e 0F3DDH (X). 

Le otto locazioni dalla 0F3DFH in avanti vengono usate dal sistema ope- 
rativo per memorizzare i valori attuali degli otto registri a sola scrittura 
del VDP. Il valore attuale del registro di stato del VDP viene memorizzato 
durante ogni intervallo di sincronismo verticale nella locazione OF3E7H. 
Le locazioni dalla 0F3E9H alla 0F3EBH vengono usate per memorizzare 
i colori correnti per lo sfondo, il primo piano e il bordo dello schermo, così 
come vengono impostati tramite il comando COLOR del BASIC. 

Il sistema memorizza l’indirizzo più alto che trova nella RAM nelle loca- 
zioni 0F672H e 0F673H. Questi indirizzi possono essere cambiati per “na- 
scondere” alcune zone della RAM al BASIC e al sistema operativo, in mo- 
do da aumentare la sicurezza del codice messo in queste aree. I due byte 
che seguono questi indirizzi definiscono l’indirizzo più alto che può essere 
usato dallo stack. 

Le 26 locazioni che partono dall’indirizzo 0F6CAH vengono usate per ri- 
cordare i tipi di default delle variabili con inziale dalla A alla Z. Questa 
tabella viene modificata con delle istruzioni DEFINT, DEFSTR, DEFSNG 
ecc. ed è letta quando viene incontrata una qualsiasi variabile non accom- 
pagnata da un suffisso che ne indichi esplicitamente il tipo. I tipi delle va- 
riabili sono: 
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Intero: valore in tabella 2. 

Stringa: valore in tabella 3. 

Singola precisione: valore in tabella 4. 

Doppia precisione: valore in tabella 8. 

Si noti che il default per tutte le entrate della tabella è sempre “doppia pre- 
cisione”. 

Infine, dalla 0FD9AH alla OFFCAH, troviamo il blocco degli “agganci” 
di ridirezione alla RAM ciascuno dei quali consiste in 5 byte inizializzati 
con l’istruzione Z-80 RET (0C9H). La maggior parte di questi “agganci” 
sono stati previsti per future espansioni del sistema e risultano di limitata 
utilità per il programmatore. Quelli invece di uso immediato verranno di- 
scussi quando li si incontrerà nell’esaminare il resto del sistema. 



Chiamate da BASIC di sottoprogrammi in codice macchina 

I segreti per interfacciare correttamente procedure scritte in codice mac- 
china con il BASIC sono essenzialmente due: prima di tutto “nascondere” 
la routine in codice macchina in modo che il BASIC non possa, per errore, 
sovrascrivere nella sua area, e, seconda cosa, passare alla routine stessa dei 
parametri e leggerne i risultati. 

II metodo più semplice per riservare spazio alle procedure in codice mac- 
china è l’uso dell’istruzione BASIC CLEAR ni, n2. Il primo parametro in- 
dica lo spazio riservato per la memorizzazione delle stringhe, mentre il se- 
condo determina l’indirizzo più alto che può essere acceduto dal BASIC. 
Quindi per riservare i 16K più alti della RAM al codice macchina e per 
predisporre uno spazio di 200 byte per le stringhe è necessario usare il co- 
mando CLEAR 200,&HBFFF. Si noti però che in circostanze normali l’a- 
rea di lavoro del sistema rimane quella dalla locazione 0F380H in avanti. 
Per chiamare routine in codice macchina dal BASIC si deve fare ricorso 
alla funzione USRn; la sintassi di quest’ultima è: 

Variabile = USRn(variabile/costante) oppure 
PRINT USRn(variabile/costante) 

dove n è il numero delia routine utente definito dalla DEFUSR e sia varia- 
bile sia variabile/costante possono essere di un tipo qualunque. 

Quindi se vogliamo passare una stringa ad una routine che deve ritornare 
un valore intero, possiamo chiamarla cosi: 

A% = USR1(“abcde“) 
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La chiamata alla USR effettua un passaggio dei valori secondo la seguente 
modalità: 

Intero: la locazione 0F663H.contiene 2, e il valore è memorizzato in 0F7F8H 
e 0F7F9H (il primo è il byte meno significativo). 

Stringa: la locazione 0F663H contiene 3, e 0F7F8H e 0F7F9H contengono 
l’indirizzo del descrittore della stringa. Un descrittore di una stringa è com- 
posto da tre byte: la sua lunghezza e l’indirizzo dove è effettivamente me- 
morizzata la stringa stessa. 

Singola precisione: la locazione 0F663H contiene 4, e il valore è memoriz- 
zato nella locazioni dalla 0F7F6H alla 0F7F9H. 

Doppia precisione: la locazione 0F663H contiene 8, ed il valore è memo- 
rizzato nelle locazioni dalla 0F7F6H alla 0F7FDH. 

1 parametri possono essere ritornati al BASIC in una maniera altrettanto 
semplice. Il programma che segue illustra questo problema: viene acquisita 
una stringa numerica che rappresenta un valore in base tre, e viene ritorna- 
to come intero il decimale equivalente. 

VARTYP EQU 0F663H 
VARPTR EQU 0F7F8H 
ORG 09000 H 

START: LD A, (VARTYP) 

CP 3 
RET NZ 

LD HL, (VARPTR) 

LD B,(HL) 

INC HL 
LD E,(HL) 

INC HL 
LD D,(HL) 

LD HL,0 

ICLP: PUSH DE 

PUSH HL 
ADD HL,HL 
POP DE 
ADD HL.DE 
POP DE 



;VAR È UNA STRINGA? 

;SE NON LO È RETURN 
;PRENDE L'INDIRIZZO 
;DEL DESCRITTORE 
;LUNGHEZZA DELLA STRINGA 
; 1 N B 

INDIRIZZO DELLA STRINGA 
;IN DE 



;VUOTA HL 
; SALVA I REGISTRI 



VALBIN =VALBIN*3 
PRENDE IL PUNTATORE ALLA 
STRINGA CORRENTE 
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EX DE.HL 
LD A,(HL) 

SUB ’O’ 

INC HL 
PUSH HL 
LD L,A 
LD H,0 
ADD HL,DE 
POP DE 

DJNZ ICLP 

LD (VARPTR).HL 
LD A, 2 

LD (VARTYP),A 
RET 

END 



;IN HL E VALBIN IN DE 
;PRENDE DALLA STRINGA 
;l CARATTERI SUCCESSIVI 
;LI CONVERTE IN NUMERICO 
JNCREMENTA LA STRINGA PTR 
;LA SALVA 

; METTE IL NUMERO IN HL 
;VALBIN = VALBIN + NUM 
; PUNTATORE ALLA STRINGA 
; I N DE 

;SE VI SONO ANCORA 
; STRINGHE LO RIPETE 
; VALBIN IN VARPTR 

;VARTYP = I NTEGER 
;AL BASIC 
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Capitolo 6 



IL PROCESSORE VIDEO 



Il processore video (VDP, dall’inglese Video Display Processor) si interfac- 
cia con la CPU attraverso un bus dati bidirezionale su 8 bit, tre linee di 
controllo e un’interruzione. Si possono effettuare quattro tipi di operazio- 
ni: scrittura di dati nella VRAM, lettura di dati dalla VRAM, scrittura dei 
registri di controllo del VDP e lettura del registro di stato del VDP stesso. 
Ciascuna di queste operazioni implica uno o più trasferimenti di dati sul 
bus d’interfaccia tra il VDP e la CPU, dove l’interpretazione di questi tra- 
sferimenti è legata allo stato delle tre linee di controllo. La CPU può co- 
municare con il VDP in modo asincrono rispetto alla scansione video del- 
la televisione poiché il VDP consente l’accesso alla VRAM anche durante 
il periodo in cui viene effettuata la scansione video. 



Le linee di controllo 

Le tre linee di controllo (CSW, CSR e MODE) determinano l’interpreta- 
zione dei trasferimenti dati da parte del VDP. La linea CSW è attiva (bas- 
sa) quando è in corso un trasferimento dalla CPU al VDP. La linea CSR 
è attiva (bassa) quando deve essere fatta una lettura da parte della CPU. 
Le due suddette linee' non sono mai attive simultaneamente. 

La linea MODE indica la sorgente o la destinazione di un’operazione di 
lettura o di scrittura, e, nella attuale configurazione del MSX, viene colle- 
gata alla linea 0 del bus indirizzi della CPU. La figura 6.1 illustra global- 
mente le operazioni d’interfaccia tra VDP e CPU, che vengono descritte 
in seguito. 
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La CPU scrive nei registri del VDP 

Il VDP ha otto registri di controllo a sola scrittura e un registro di stato 
a sola lettura. 

Ciascuno degli otto registri a sola scrittura può essere caricato da parte della 
CPU con due soli trasferimenti di dati su 8 bit (lo stato della linea di con- 
trollo per ottenere questa e tutte le altre operazioni si trova nella tabella 
6.1). Il primo byte trasferito è il dato che deve essere scritto, mentre con 
il secondo si specifica il registro destinazione (da 0 a 7, decimale: il bit più 
significativo a 1 indica una scrittura di registro; se posto a 0 indica invece 
un’operazione di configurazione dell’indirizzo della VRAM). 

Per riscrivere dati nei registri interni dopo che è già stato trasferito un byte 
dato, è necessario leggere il registro di stato del VDP per poter rinizializza- 
re la logica dell’interfaccia. Questa situazione è abbastanza frequente in am- 
bienti operativi, come quello del MSX, guidati da interruzioni. In genera- 
le, qualora sia dubbio lo stato dei parametri di lettura/scrittura del VDP, 
è opportuno svolgere la suddetta procedura. 

La CPU scrive nella VRAM 

Il trasferimento dati dalla CPU alla VRAM viene effettuato utilizzando 
un registro d’indirizzamento su 14 bit che si autoincrementa. I primi due 
byte trasferiti in scrittura alla VRAM vengono usati per impostare corret- 
tamente il suddetto registro: le scritture successive richiedono quindi il tra- 
sferimento di un solo byte, poiché l’indirizzo è già stato specificato e l’in- 
cremento avviene automaticamente. 

La CPU legge il registro di stato del VDP 

La CPU può leggere il registro di stato del VDP con il trasferimento di un 
solo byte. Viene attivata la linea MODE (alta) per il trasferimento e la li- 
nea CSR viene usata per indicare che si sta compiendo un’operazione di 
lettura. 

La CPU legge dalla VRAM 

La lettura da parte della CPU nella VRAM avviene in modo del tutto ana- 
logo a quello della scrittura, anche in questo caso utilizzando il registro 
di indirizzamento ad autoincremento. 

Temporizzazione 

Poiché la CPU agisce sulla VRAM tramite il VDP è ovvio che i trasferi- 
menti possono avvenire solamente quando il VDP non è impegnato in at- 
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tività di visualizzazione di output sullo schermo; ne consegue che il tempo 
necessario per il trasferimento da parte della CPU di un byte da e per la 
VRAM varia da 2 a 8 microsecondi, in dipendenza dell’occupazione del 
VDP in attività di visualizzazione o “refresh” di memoria. Le temporizza- 
zioni approssimative vengono indicate nella tabella 6.2. 



I registri del VDP 



Solo i registri 0 e 1, tra gli otto a sola scrittura, contengono i flag che con- 
trollano la varie funzioni e modalità del VDP. I registri dal 2 al 6 conten- 
gono dei valori che indicano gli indirizzi di partenza dei vari sottoblocchi 
della VRAM, mentre il registro 7 viene usato per definire il colore di sfon- 
do in tutte le modalità video e i colori del testo nella modalità a 40 colon- 
ne. Seguono ora le descrizioni dettagliate di questi registri: 

Registro 0 

I due bit meno significativi sono bit di controllo. Tutti i rimanenti sono 
riservati per future espansioni e devono essere posti a zero. 

Bit 0: Abilita/disabilita VDP esterno (1 = abilita) 

Bit 1: Bit 3 di modalità: si veda il seguito per ulteriori dettagli. 

Registro 1 (8 bit di controllo del VDP) 

Bit 7: Selezione 4/16K RAM (sempre a 1 nel sistema MSX) 

Bit 6: Abilita/disabilita la cancellazione dello schermo (1 = abilita); la can- 
cellazione implica che l’intero schermo assuma il colore di sfondo. 

Bit 5: Abilita l’interruzione (1 = abilita, 0 = disabilita) 

Bit 4: Bit 1 di modalità 

Bit 3: Bit 2 di modalità; questi due ultimi, con il bit 3 del registro 0, defini- 
scono la modalità di schermo, secondo lo schema riportato di seguito: 



MI M2 M3 

0 0 0 

0 0 1 

0 10 
1 0 0 



Modalità Grafica / 
Modalità Grafica li 
Modalità multicolore 
Modalità testo 



Bit 2: Riservato per future espansioni, deve essere posto a zero. 

Bit 1: Selezione della dimensione degli sprite: 0 implica sprite di 8 * 8 pixel, 
1 sprite di 16 * 16. 
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Bit 0: Selezione dell’opzione d’ingrandimento degli sprite: 0 implica sprite 
di dimensioni normali, 1 sprite ingranditi. 

Registro 2 

I quattro bit meno significativi del registro 2 formano i quattro bit di ordi- 
ne più alto dell’indirizzo, su quattordici bit, della tabella dei nomi; ne con- 
segue che l’indirizzo di partenza della tabella dei nomi è pari a (Registro 
2)*400H. 

Registro 3 

II registro 3 determina l’indirizzo della VRAM da cui parte la tabella dei 
colori. 11 contenuto di questo registro costituice gli otto bit di più alto ordi- 
ne dell’indirizzo su 14 bit: quindi quest’ultimo può essere calcolato come 
(Registro 3)*40H. 

Registro 4 

1 tre bit meno significativi definiscono l’inizio del generatore di sottobloc- 
chi per le tabelle dei modelli, dei testi e multicolore, formando così i tre 
bit piu significativi delFindirizzo. Ne consegue che l’indirizzo del genera- 
tore di sottoblocchi deve essere calcolato come (Registro 4)*800H. 

Registro 5 

I sette bit più “bassi” di questo registro formano i 7 bit più significativi 
dell’indirizzo della tabella degli attributi degli sprite; quindi l’indirizzo di 
base è dato da (Registro 5)*80H. 

Registro 6 

II registro 6 definisce l’indirizzo d’inizio, nella VRAM, della tabella gene- 
ratrice dei modelli degli sprite. L’indirizzo è uguale a (Registro 6)*800H. 

Registro 7 

I quattro bit più significativi del registro 7 contengono il codice di colore 
per il colore nella modalità testo, mentre i quattro bit meno significativi 
determinano il codice di colore per il colore 0 nella modalità testo, o il co- 
lore dello sfondo per tutte le altre modalità. 

II registro di stato 

Il VDP ha un solo registro di stato su 8 bit che può essere accessibile dalla 
CPU. Questo registro contiene i flag d’interruzione, di collisione tra due 
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aprite, di “quinto sprite”, e il numero del quinto sprite. Il formato del regi- 
stro di stato viene descritto in seguito. 

Il registro di stato può essere letto in qualsiasi momento. Però se esso viene 
letto in modo asincrono rispetto all’interruzione generata dal segnale vi- 
deo, il flag connesso alla memoria video viene posto a zero e ciò può cau- 
sare la perdita dell’interruzione stessa. Per evitare che ciò accada è consi- 
gliabile leggere la copia del registro di stato del VDP che viene mantenuta 
dal sistema operativo nella RAM (si veda Capitolo 5). 

Bit 7: il flag d’interruzione 

Questo flag viene posto a 1 alla fine della scansione elettronica dell’ultima 
linea del video. La conseguenza è quella di attivare anche la linea d’inter- 
ruzione, a patto che sia posto a 1 il flag di abilitazione delle interruzioni 
del registro 0. Il flag d’interruzione viene rimesso a zero quando si legge 
il registro di stato; si noti che questa lettura deve èssere effettuata al termi- 
ne di ogni scansione video proprio allo scopo di rinizializzare il flag di in- 
terruzione e quindi riabilitarlo per la successiva scansione video. 

Bit 5: il flag di sovrapposizione di sprite 

Questo flag viene posto a 1 quando si verifica una collisione tra due sprite 
(cioè quando si hanno uno o più pixel in sovrapposizione). Gli sprite tra- 
sparenti vengono considerati, così come quelli che sono totalmente o par- 
zialmente fuori dallo schermo. Gli sprite che si trovano oltre il delimitatore 
della tabella degli attributi degli sprite (0D0H) non vengono però conside- 
rati. Il flag viene rimpostato a zero quando viene letto il registro di stato. 

Bit 6: il flag di “quinto sprite” 

Il bit 6 del registro di stato viene posto a 1 quando su una medesima linea 
dello schermo sono presenti cinque o più sprite contemporaneamente. Vie- 
ne posto a zero quando viene letto il registro di stato. Quando è posto a 
1, il numero del quinto sprite viene messo nei cinque bit meno significativi 
del registro di stato, consentendo all’utente di muovere lo sprite prima del- 
la prossima scansione video, in modo che tutti gli sprite siano posizionati 
correttamente. 



Modalità di visualizzazione 

Il VDP genera un’immagine che può essere pensata come composta da un 
certo numero di piani sovrapposti. L’ordine di priorità di questi piani è le- 
gato all’ordine di sovrapposizione in profondità (il piano più lontano è quello 
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a più bassa priorità): ne consegue che se due oggetti si trovano nella mede- 
sima posizione su due piani diversi, l’oggetto che si trova sul piano a più 
alta priorità precluderà l’altro (e ogni altro che si trovi su piani di priorità 
inferiore). Se ne può quindi dedurre che uno sprite sul piano 0 apparirà 
davanti a tutto ciò che compare nella schermata attuale. Partendo dal più 
esterno, questi piani sono: i 32 piani per gli sprite, seguiti dal piano dei 
caratteri, seguito dal piano di sfondo, seguiti a loro volta dai piani relativi 
agli eventuali VDP connessi esternamente. Non sembra tuttavia che le com- 
pagnie che producono lo standard MSX intendano usare più di un proces- 
sore video. 

Il piano dello sfondo presenta una colorazione uniforme che viene usata 
per la visualizzazione delle aree del bordo ed è il colore di default per il 
piano dei caratteri. , 

Quando viene impostato con il colore trasparente, automaticamente assu- 
me per default il nero, a meno che non siano presenti altri VDP esterni. 
I 32 piani degli sprite sono posti davanti al piano dei caratteri: Io sprite 
31 ha la priorità più bassa e lo sprite 0 quella più alta. Questi piani vengo- 
no disattivati nella modalità testo. Per default gli sprite sono trasparenti 
e le loro posizioni possono essere definite pixel per pixel, consentendo quindi 
un movimento senza scatti. Il contenuto e la memorizzazione del piano dei 
caratteri varia tra le modalità di visualizzazione e quindi verrà discusso se- 
paratamente. 

In tutte le modalità sono disponibili i seguenti 16 colori: 



CODICE 


COLORE 


0 


Trasparente 


1 


Nero 


2 


Verde medio 


3 


Verde chiaro 


4 


Blu scuro 


5 


Blu chiaro 


6 


Rosso scuro 


7 


Ciano 


8 


Rosso medio 


9 


Rosso chiaro 


10 


Giallo scuro 


11 


Giallo chiaro 


12 


Verde scuro 


13 


Rosso Magenta 


14 


Grigio 


15 


Bianco 
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Modalità Grafica I 



Nella modalità grafica I il sottoblocco di VRAM che costituisce la tabella 
dei nomi è composto da 768 byte, logicamente divisi in 24 righe per 32 ca- 
ratteri. Quindi i primi 32 caratteri della tabella rappresentano la prima li- 
nea del video, i successivi 32 la seconda e così via. Ciascun elemento della 
tabella fa riferimento a una delle 256 definizioni di modello contenute nel- 
la tabella di generazione dei modelli. Ognuna di queste definizioni è com- 
posta da otto byte (8*8 bit), e quindi l’occupazione totale è di 2048 byte 
della VRAM. In queste definizioni un bit posto a 1 implica la visualizza- 
zione del pixel corrispondente con colore 1; un bit posto a 0 implica il co- 
lore 0. I colori per ciascun modello vengono determinati dalla tabella dei 
colori (che nella modalità Grafica I è lunga 32 byte). In questa tabella ogni 
elemento definisce un colore di primo piano (colore 1) e uno di sfondo (co- 
lore 0) per otto modelli della tabella di generazione dei modelli. Infatti il 
primo elemento della tabella dei colori si riferisce ai modelli dallo 0 al 7, 
il secondo ai modelli dall’8 al 15 e così via. Gli elementi della tabella dei 
colori sono logicamente considerati come due semibyte: il più significativo 
indica il colore di primo piano, l’altro il colore di sfondo. Da quanto detto 
si può dedurre che la completa implementazione di questa modalità richie- 
de l’occupazione di 2848 byte di VRAM: se però non è necessaria la defini- 
zione di tutti i 256 modelli, è possibile sovrapporre parzialmente le tabelle. 



Modalità Grafica II 

Nella modalità Grafica II, la tabella dei nomi viene rappresentata come nella 
modalità Grafica I, con l’eccezione che ogni elemento di questa tabella può 
avere la sua unica definizione nella tabella di generazione dei modelli. 
Ciò è possibile in quanto la tabella di generazione dei modelli viene divisa 
in tre blocchi, ciascuno comprendente 256 definizioni; i primi 256 elementi 
della tabella dei nomi (vale a dire la parte superiore dello schermo) si rife- 
riscono alle prime 256 definizioni della tabella di generazione dei modelli; 
analogamente gli elementi della parte centrale fanno riferimento alle defi- 
nizioni dalla 256 alla 511 e quelli della parte inferiore dello schermo usano 
le definizioni dalla 512 alla 767. 

È inoltre possibile definire il colore di primo piano e di sfondo di ogni li- 
nea orizzontale di ciascuna definizione di modello. Infatti la tabella dei colori 
è formata da 768 elementi, ciascuno di otto byte. Ciascuno di questi è in 
corrispondenza con una definizione della tabella di generazione dei mo- 
delli. I quattro bit più significativi di ogni byte della tabella dei colori defi- 
niscono il colore di primo piano del byte corrispondente nella tabella dei 
modelli, mentre gli altri quattro determinano il colore di sfondo. 
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Come si può vedere, se si usa un’attenta configurazione dei valori contenu- 
ti nella tabella dei nomi, la modalità Grafica li può essere considerata “bit- 
mapped”; viceversa copiando i medesimi valori in tutti e tre i blocchi della 
tabella di generazione dei modelli e nella tabella dei colori questa modalità 
può essere sfruttata in modo analogo alla modalità Grafica I, ma con una 
migliore definizione del colore. 



Modalità multicolore 

La modalità multicolore consente di utilizzare una schermo con 64 * 48 
quadrati di colore, ciascuno dei quali è formato da un blocco di 4 * 4 pixel. 
Ognuno di questi quadrati può essere in uno dei 15 colori disponibili nel 
VDP. 

La tabella dei nomi nella modalità multicolore è mappata in modo simile 
alle due modalità grafiche, anche se non vi è più riferimento ad una tabella 
di colori. Infatti il colore viene ora determinato dagli elementi della tabella 
di generazione dei modelli. 

Ciascun valore nella tabella dei nomi punta ad un blocco di otto byte nella 
tabella di generazione dei modelli. Solo due di questi byte vengono usati 
per definire l’immagine che viene visualizzata: vengono considerati come 
una serie di quattro semibyte che definiscono un modello multicolore di 
8*8 pixel. 11 semibyte di ordine più alto del primo byte definisce il colore 
del quadrato di 4 * 4 pixel che si trova in alto sulla sinistra nel modello 
di 8 * 8 pixel; il semibyte meno significativo definisce il colore del quadra- 
to in alto a destra; il secondo byte si comporta in modo analogo per quan- 
to riguarda i quadrati in basso, rispettivamente a sinistra e a destra, nel 
modello multicolore di 8 * 8 pixel. Gli elementi delle righe 0, 4, 8, 12, 16 
e 20 della tabella dei nomi usano i primi due byte del blocco di otto byte 
della tabella di generazione dei modelli, mentre gli elementi delle righe 1, 
5, 9, 13, 17 e 21 usano i successivi due byte e così via. 



Modalità testo 

Nella modalità testo lo schermo viene considerato come una griglia di 40 
caratteri su 24 linee.'Ciascun elemento della griglia si estende per 6 pixel 
in orizzontale e per 8 in verticale. Le tabelle che vengono utilizzate per ge- 
nerare il piano dei modelli sono la tabella dei nomi e la tabella di genera- 
zione dei modelli: possono esistere contemporaneamente 256 definizioni 
di modelli. La tabella dei nomi collega queste definizioni con ciascuno dei 
960 elementi del piano dei modelli. In questa modalità non sono disponi- 
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bili gii sprite. La tabella di generazione dei modelli è identica a quella del- 
la modalità Grafica 1 con l’eccezione che, poiché ogni carattere si estende 
in orizzontale per soli 6 pixel, i due bit meno significativi di ciascun byte 
nella tabella di generazione dei modelli vengono ignorati. I colori di primo 
piano e di sfondo sono determinati dal valore del registro 7 del VDP: il 
semibyte alto definisce quello di primo piano, mentre quello basso deter- 
mina il colore di sfondo e del bordo. 



Sprite 

Sullo schermo possono essere visualizzati fino a 32 sprite, che si muovono 
sui piani a più alta priorità. La loro posizione viene definita dall’angolo 
in alto a sinistra del modello di definizione, e, poiché la posizione può es- 
sere definita pixel per pixel, risulta semplice far muovere lentamente e sen- 
za scatti lo sprite sul suo piano. Ciascuno dei piani degli sprite è del tutto 
trasparente tranne la zona in cui si trova lo sprite stesso. Gli sprite non so- 
no disponibili nella modalità testo a 40 colonne. 

Nella VRAM si trovano la tabella degli attributi degli sprite e la tabella 
di generazione dei modelli degli sprite. Queste tabelle sono sostanzialmen- 
te analoghe a quelle che agiscono nel piano dei modelli: infatti la tabella 
degli attributi degli sprite determina la posizione dello sprite, mentre la ta- 
bella dei modelli degli sprite contiene la definizione del suo disegno. 
Ciascuno dei 32 elementi della tabella degli attributi degli sprite consiste 
in quattro byte: questi indicano la sua coordinata verticale, seguita da quella 
orizzontale, seguita dal nome (che fa riferimento alla tabella di generazio- 
ne dei modelli per gli sprite), seguita infine dal suo “tag”, i cui quattro bit 
meno significativi ne definiscono il colore e il bit più significativo è il bit 
di “early clock”. Quest’ultimo fa in modo che lo sprite appaia 32 pixel sul- 
la sinistra della sua posizione, che, come detto, è determinata dai primi due 
byte degli elementi della tabella degli attributi degli sprite. 

Quando uno sprite viene posizionato in 0,0 appare attaccato al margine 
sinistro in alto del bordo. In molte applicazioni però è necessario che lo 
sprite faccia la sua apparizione sullo schermo partendo dai bordi estremi. 
Per ottenere questo effetto esiste un metodo differente per ognuno dei due 
assi, vale a dire:- 

Innanzitutto la posizione verticale può assumere anche valori negativi: i 
valori compresi tra — 31 e 0 (in complemento a due) permettono allo sprite 
di apparire gradualmente dal margine superiore dello schermo. Si può pe- 
rò facilmente dedurre che, poiché la risoluzione orizzontale dello schermo 
è di 256 pixel, questo metodo non può essere applicato ài margine sinistro; 
è questo appunto lo scopo per il quale è stato introdotto il bit di “early 
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Fig. 6.2 - Mappa per gii sprite 16*16. 
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clock” nel quarto byte di ogni elemento della tabella degli attributi degli 
sprite. 

La tabella di generazione dei modelli per gli sprite consiste in un massimo 
di 256 elementi di otto byte; il terzo byte di ciascun elemento della tabella 
degli attributi degli sprite definisce quale elemento della tabella di genera- 
zione dei modelli debba essere usato per lo sprite nel piano che si sta consi- 
derando. Si noti che quando si usano sprite di 16 * 16 pixel questo valore 
è considerato per multipli di quattro, puntando quindi a blocchi di 32 byte 
nella tabella di generazione degli sprite. 

Si deve infine notare che su una linea orizzontale possono essere visualiz- 
zati fino ad un massimo di quattro sprite. Nel caso in cui questa regola 
venisse violata, appaiono sullo schermo solo i quattro sprite a più alta prio- 
rità; inoltre il flag di “quinto sprite” nel registro di stato del VDP verrebbe 
posto a 1, e il numero del quinto sprite verrebbe memorizzato nei suoi cin- 
que bit di più basso ordine. 



II VDP in ambiente MSX 

Nel sistema MSX il VDP può essere accessibile in due modi. In primo luo- 
go la ROM di sistema del MSX fornisce una serie di procedure con le quali 
l’utente può effettuare la maggior parte delle operazioni necessarie. In qual- 
che caso però queste procedure possono rivelarsi inadeguate per la funzio- 
nalità offerta o per il tempo di esecuzione: in tal caso è possibile un acces- 
so diretto al VDP tramite le locazioni 6 e 7 della ROM di sistema, in cui 
sono contenuti gli indirizzi di scrittura e lettura per il VDP. 

Può forse apparire strano, a prima vista, che siano necessari due indirizzi: 
un’analisi più approfondità ci porterà a capire che la giustificazione di ciò 
è la linea di controllo MODE del VDP. 

Facendo riferimento alla tabella 6.1, possiamo vedere che per scrivere in 
un registro del VDP la linea di controllo MODE deve essere attiva (alta), 
mentre deve essere disattiva (bassa) per una lettura o scrittura nella VRAM. 
Poiché, come già detto in precedenza, la linea di controllo MODE è legata 
a una delle linee d’indirizzo della CPU, potremmo aspettarci che gli indi- 
rizzi memorizzati nelle locazioni 6 e 7 siano tra loro differenti per un solo 
bit. Esaminando la ROM, troviamo che la locazione 6 contiene 98H e la 
7 contiene 99H: se ne può dedurre che la linea MODE è legata alla linea 
0 d’indirizzo. Le altre due linee di controllo del VDP, la CSR e la CSW 
sono legate alle linee di controllo IORQ, RD e WR della CPU, in modo 
che il loro controllo venga effettuato automaticamente. La procedura ri- 
portata qui di seguito scrive, nella locazione di VRAM specificata da un 
indirizzo su 14 bit contenuto nella coppia di registri HL, il dato contenuto 
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nell’accumulatore, ed è utile per illustrare quanto appena detto: 



WRTVRM: PUSH AF 

LD A, (6) 

LD C,A 
INC C 
DI 

OUT (C),L 

SET 6,H 

OUT (C),H 
DEC C 
POP AF 
OUT (C),A 
El 

RET 



SALVA I DATI 

PRENDE L’INDIRIZZO DI VDP CON LA 

LINEA MODE ALTA 

LO COPIA IN C 

LINEA MODE ALTA 

DISABILITA LE INTERRUZIONI 

USCITA DEL BYTE INFERIORE 

DELL'INDIRIZZO 

PONE A 1 IL BIT 6 DEL BYTE SUPERIORE 

DELL’INDIRIZZO 

LO FA USCIRE 

LINEA MODE BASSA 

RIPRISTINA I DATI 

LI STAMPA 

RIABILITA LE INTERRUZIONI 
RETURN 



11 sistema operativo rende disponibili delle routine, ben scritte e ottimizza- 
te come tempo di esecuzione, per tutte le funzioni che è probabile siano 
necessarie; le prenderemo ora in esame: 



INDIRIZZO FUNZIONE 

0041 H Disabilita la visualizzazione su schermo. Non è richiesto al- 

cun parametro, ma vengono modificate le coppie di registri 
AF e BC. 

0044H Abilita la visualizzazione su schermo: anch’essa non richie- 

de alcun parametro e modifica le coppie AF e BC. 

0047H Scrive il dato posto in B nel registro specificato da C, modi- 

ficando le coppie AF e BC. 

004AH Legge un byte della VRAM all’indirizzo contenuto nella cop- 

pia FIL: il valore viene ritornato nell’accumulatore e viene 
modificata solo la coppia AF. 

004DH Scrive il dato contenuto nell’acciftnulatore all’indirizzo di 

VRAM specificato dalla coppia HL, modificando solamente 
AF. v 

0050H Prepara il VDP per un’operazione di lettura dalla VRAM: 

accetta come parametro l’indirizzo di partenza in HL e mo- 
difica la coppia AF. 

005 3 H Analoga alla precedente per quanto concerne un’operazio- 

ne di scrittura. 
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0056H Questa routine riempie il numero di byte di VRAM specifi- 

cati nella coppia BC, a partire dalFindirizzo posto in HL 
con i dati passati per mezzo dell’accumulatore. Modifica le 
coppie AF e BC. 

0059H Sposta un blocco di memoria dalla VRAM alla RAM. È ana- 

loga alla routine che segue. 

005CH Sposta un blocco di memoria dalla memoria della CPU al- 

la VRAM. L’indirizzo di partenza è in HL, quello di desti- 
nazione in DE e la lunghezza del blocco è posta in BC; tutti 
i registri vengono modificati. 

005FH Imposta il VDP alla modalità di visualizzazione definita dalla 

locazione OOCAFH (0 per testo 40, 1 per Grafica I, 2 per 
grafica II, 3 per multicolore). Modifica tutti i registri. 

0062H Cambia il colore dello schermo: i parametri sono il colore 

di primo piano (nella locazione 0F3EAH), quello di sfon- 
do (locazione 0F3EAH) e quello del bordo (locazione 
0F3EBH). Modifica tutti i registri. 

0069H Inizializza tutti gli sprite. I modelli degli sprite vengono can- 

cellati, i nomi degli sprite vengono posti uguali ai numeri 
del piano di ogni sprite, i colori sono posti uguali al colore 
di primo piano e le posizioni verticali al valore 209. Questa 
routine richiede che venga passata la modalità video nella 
locazione OFCAFH e modifica inoltre tutti i registri. 

006CH Inizializza il VDP per la modalità testo su 40 colonne. Que- 

sta routine usa i valori che si aspetta di trovare nell’area del- 
la RAM di sistema dall’indirizzo 0F3B3H in avanti e modi- 
fica tutti i registri. 

006FH Inizializza il VDP per la modalità Grafica I; le due routine 

che seguono sono del tutto analoghe a questa. 

0072H Inizializza il VDP per la modalità Grafica II. 

0075H Inizializza il VDP per la modalità multicolore. 

In circostanze normali è piuttosto improbabile che si renda necessario un 

accesso diretto al VDP da parte dell’utente. 



La programmazione del VDP: informazioni e suggerimenti 

Il piano di visualizzazione dei caratteri 

Nelle modalità Grafica I e II, che sono quelle che più interessano il pro- 
grammatore, quel che appare sul piano dei caratteri è completamente de- 
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terminato dalle sue scelte: infatti la definizione di tutti i caratteri viene pre- 
sa dalla RAM. Si può però facilmente dedurre che sarebbe consigliabile, 
nella definizione di un proprio insieme di caratteri, seguire certe indicazio- 
ni di massima. Per esempio, lavorando sulle macchine MSX si è visto che 
è consigliabile mettere almeno la definizione delle lettere maiuscole e dei 
numeri in locazioni della VRAM in modo che sia possibile scrivere il codi- 
ce ASCII di una lettera o di una cifra nella tabella dei nomi per ottenerne 
la visualizzazione. Per esempio la definizione di una ‘A’ (codice ASCII 65) 
dovrebbe essere posta a un indirizzo della VRAfrf calcolabile nel seguente 
modo: (indirizzo di base dalla tabella di generazione dei modelli) + (65 * 8). 
Per esperienza personale ho potuto constatare che il modo più semplice 
per ottenere ciò consiste nel prendere le definizioni di base dalla ROM e 
ridefinire quindi quelle che si vuole. Quest’operazione viene fatta dal siste- 
ma operativo nella modalità Grafica I, con un comando SCREEN 1; però 
quando si ritorna alla modalità Grafica II con un comando SCREEN, il 
sistema operativo imposta il VDP con tutte le 768 definizioni rinizializza- 
te. Diventa quindi necessario localizzare nella ROM di sistema MSX la de- 
finizione standard dei caratteri. Essa può cambiare da macchina a macchi- 
na: il piccolo programma che segue serve per individuare l’indirizzo della 
’A’ nella ROM MSX: 

10 FOR N % = &H0000 TO &H7FFF 
20 A% = PEEK(N%):READ B% 

30 IF A% < > B% THEN RESTORE:Q% =0 ELSE Q% =Q% + 1 
40 IF Q% =8 THEN PRINT HEX$(N%— 8):END 
50 NEXT N % 

60 END 

70 DATA 32,80,136,136,248,136,136,0 



I programmi BASIC e in codice macchina che seguono illustrano molte delle 
questioni che devono essere prese in considerazione quando si programma 
il VDP. Viene inoltre fornito un potente programma per la definizione di 
caratteri e di sprite, principalmente da usare nella modalità Grafica II (ma 
funziona anche nelle altre modalità). 



WRTVDP EQU 47H 
RDVRM EQU 4AH 
WRTVRM EQU 4DH 
FILVRM EQU 56H 
LDIRVM EQU 5CH 
LDIRMV EQU 59H 
CHGET EQU 9FH 



;CHIAMA LA TABELLA DEI BIOS 



137 





START: LD E, 8 

LD IX.REGDAT 
LD D,0 

SVDPLP: LD B,(IX + 0) 

LD C,D 

CALL WRTVDP 
INC IX 

INC D 



DEC E 

JR NZ, SVDPLP 
LD HHL.CHARDT 

LD DE,PATTAB + 1100H 
LD BC,60*8 
CALL LDIRVM 
LD BC.800H 
LD HL.COLTAB + IOOOH 



INDICATORE DEI DATI IN IX 
CARICA I REGISTRI 
DATI IN B 

NUMERO DEL REGISTRO IN C 
AL VDP 

INCREMENTA L'INDICATORE 
DEI DATI 

INCREMENTA IL NUMERO 
DEL REGISTRO 



FORMA 8 REGISTRI 
PRENDE L'INDIRIZZO 
DEI CARATTERI 
DE È L'INDIRIZZO DI VRAM 
FORMA 60 CARATTERI 
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;FORMA I COLORI 



MLP: 



NDFNC: 



LD A.0F1H 
’CALL FILVRM 
LD BC.800H 
LD HL.COLTAB 
LD A,1FH 



CALL FILVRM ;FORMA I COLORI 

LD BC.800H 
LD HL.COLTAB + 800H 
LD A.81H 

CALL FILVRM ;PIÙ COLORI 

LD BC.768 
LD HL.NAMTAB 
LD A, 32 

CALL FILVRM ;PULISCE LO SCHERMO 

LD HL.P2DAT 
LD DE.PATTAB + 800H 
LD BC.24 

CALL LDIRVM ;DEFINISCE I CARATTERI 

;DA 0 A 2 NEL BLOCCO 2 



LD HL.P2DAT+16 
LD DE.SPTTAB 
LD BC,8 
CALL LDIRVM 
CALL FUNCPT 

CALL FTTXRM 

CALL ARRYPT 

CALL SPON 
CALL JOY 
CALL FUNC 

HALT ■ 

CALL DOFUNC 

HALT 

HALT * 

CALL CHART 
CALL CSPT 
CALL COLPT 

CALL BANKPT 



DEFINISCE SPRITE 0 
;STAMPA LE COLONNE 
;DELLA FUNZIONE 
TRASFERISCE I DATI VRAM 
;ALLA RAM 
; STAMPA LA MATRICE 
;DI DEFINIZIONE 
; POSIZIONA IL CURSORE 
;LEGGE IL JOYSTICK 
;STAMPA I MESSAGGI 
;DELLA FUNZIONE 
;ASPETTA IL FLYBACK 
;ESEGUE LE FUNZIONI 
;ASPETTA IL FLYBACK 



TRASFERISCE LA DEFINIZIONE 
;DALLA MATRICE ALLA RAM 
;E STAMPA MESSAGGI 
;DI STATUS 
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CALL LPTXRM 



HALT 
JR MLP 
RET 

SPY: DEFB 0 

SPX: DEFB 0 

ARRYPT: LD C.8 

LD HL.NAMTAB + 259 

LD IX.HARRY1 
APTOLP: LD B.8 

APTILP: LD A,(IX + 0) 

PUSH BC 
CALL WRTVRM 

POP BC 
INC HL 

INC IX 

DJNZ APTILP 
LD DE.24 
ADD HL.DE 

DEC C 

JR NZ, APTOLP 
RET 

FUNCPT: LD HL.NAMTAB + 258 

CALL ROWOF8 
LD HL.NAMTAB + 267 
CALL ROWOF8 
RET 

ROWOF8: LD B,8 

R08LP: PUSH BC 

PUSH HL 
LD A, 2 

CALL WRTVRM 



TRASFERISCE I DATI VRAM 
;ALLA RAM 
; ASPETTA IL FLYBACK 
TORNA INDIETRO E RIPETE 

POSIZIONE DEL CURSORE Y 
POSIZIONE DEL CURSORE X 
ROUTINE CHE STAMPA 
LA MATRICE DI DEFINIZIONE 
INDIRIZZO DELLA TABELLA 
NOMI + OFFSET 
INDIRIZZO DEL VETTORE IN IX 
LOOP INTERNO DI 8 
PRENDE I DATI DEL VETTORE 
SALVA I CONTATORI 
SCRIVE I DATI DEL VETTORE 
SULLO SCHERMO 
RIPRISTINA I CONTATORI 
INCREMENTA IL PUNTATORE 
DELLO SCHERMO 
INCREMENTA IL PUNTATORE 
AL VETTORE 

FINE DEL LOOP INTERNO 
LUNGHEZZA DI LINEA 8 
SOMMATA AL PUNTATORE 
ALLO SCHERMO 
DECREMENTA IL CONTATORE 
DEL LOOP ESTERNO 
RIPETE 8 VOLTE 



INDIRIZZO DELLA COLONNA 
SINISTRA DEL VETTORE 
STAMPA LA COLONNA 
DESTRA DEL VETTORE 
STAMPA LA COLONNA 

CONTEGGIO DI 8 
SALVA IL CONTATORE 
SALVA L’INDIRIZZO 
CARATTERE 2 
ALL’INDIRIZZO 
DELLO SCHERMO 
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SPON: 



P2DAT: 
HARRY1 : 



POP HL 

LD DE,32 

ADD HL,DE 

POP BC 
DJNZ R08LP 
RET 

LD HL.SATTAB 

LD A,(SPY) 

SLA A 
SLA A 
SLA A 

ADD A, 63 

CALL WRTVRM 

INC HL 

LD A,(SPX) 

SLA A 
SLA A 
SLA A 
ADD A, 16 
CALL WRTVRM 

INC HL 
LD A.O 

CALL WRTVRM 

INC HL 
LD A, 15 

CALL WRTVRM 
RET - 



RIPRISTINA L'INDIRIZZO 
DELLO SCHERMO 
SOMMA LA LUNGHEZZA 
DELLA LINEA... 

ALL'INDIRIZZO 
DELLO SCHERMO 
RIPRISTINA IL CONTATORE 
FA IL CONTEGGIO DI 8 

ROUTINE DI POSIZIONAMENTO 
DEL CURSORE 

CURSORE DELLA COORDINATA Y 

MOLTIPLICA PER 8 
POICHÉ LA POSIZIONE 
DI SPRITE È CHARPOS*8 
APICE SINISTRO 
DELLA MATRICE, OFFSET 
SCRIVE NELLA TABELLA 
ATTRIBUTI SPRITE 
INCREMENTA IL PUNTATORE 
DI VRAM 

PRENDE LO SPRITE X 



SOMMA OFFSET DI X 
ALLA TAVOLA DEGLI ATTRIBUTI 
DI SPRITE 

PUNTA AL NOME DI SPRITE 
IL NOME È 0 
SCRIVE GLI ATTRIBUTI 
DI SPRITE 

INCREMENTA IL PUNTATORE 
SPRITE È BIANCO 
AGLI ATTRIBUTI 



DEFB 255,129,129,129,129,129,129,255 ;DEFINIZIONI... 
DEFB 255,255,255,255,255,255,255,255 ;DEI CARATTERI 
DEFB 255,195,165,153,153,165,195,255 ;0— 2 E SPRITE 0 
DEFB 0,0, 0,0, 0,0, 0,0 
DEFB 0,0, 0,0, 0,0, 0,0 
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;VETTORE DEI CARATTERI 



HARRY2: 

JOY: 



JOY1: 

JOY2: 

JOY3: 



DEFB 0,0, 0,0, 0,0, 0,0 
DEFB 0,0, 0,0,0, 0,0,0 
DEFB 0,0, 0,0, 0,0, 0,0 
DEFB 0,0,0, 0,0,0, 0,0 
DEFB 0,0, 0,0, 0,0, 0,0 
DEFB 0,0, 0,0, 0,0, 0,0 



DEFB 0,0, 0,0, 0,0, 0,0 
DEFB 0,0, 0,0, 0,0, 0,0 
DEFB 0,0, 0,0,0, 0,0,0 
DEFB 0,0, 0,0, 0,0, 0,0 
DEFB 0,0, 0,0, 0,0, 0,0 
DEFB 0,0, 0,0, 0,0, 0,0 
DEFB 0,0, 0,0, 0,0, 0,0 
DEFB 0,0, 0,0, 0,0, 0,0 
LD A,0 

CALL GTSTCK 

LD HL,(SPY) 

CP1 

CALL Z,DEY 
CP3 

CALL Z,INX 
CP5 

CALL Z,INY 
CP7 

CALL Z.DEX 
LD A,L 
CP8 

JR NZ.JOY1 
LD L,0 
CP 255 
JR NZ,JOY2 
LD L,7 
LD A,H 
CP10 

JR NZ.JOY3 
LD H,0 

CP 255 
JR NZ.JOY4 
LD H,9 



VETTORE TEMPORANEO 
PER TRASFORMAZIONI 
PER LEGGERE JOY(O) 

O LE FRECCE DEL CURSORE... 
CAMBIANO A PIACERE 
PER LEGGERE I JOYSTICKS 
CURSORI X,Y IN HL 
JOYSTICK AVANTI? 

SE SÌ DECREMENTA Y 
JOYSTICK A DESTRA? 

SE Sì INCREMENTA X 
JOYSTICK INDIETRO? 

SE SÌ INCREMENTA Y 
JOYSTICK A SINISTRA? 

SE Sì DECREMENTA X 
DA Y 



;SE NECESSARIO WRAP AROUND 



iULTERIORE WRAP AROUND 



;SE NECESSARIO WRAP 
;AROUND SU X 
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JOY 4: 


LD (SPY),HL 




RET 


INY: 


INC L 
RET 


DEY: 


DEC L 
RET 


INX: 


INC H 
RET 


DEX: 


DEC H 
RET 


EXIT: 


LD A,0 

LD (BASFNC).A 
POP BC 




RET 


GETMGS: 


LD A, (MENÙ) 
LD IY, MGSTAB 
SLA A 
LD C,A 




LD B,0 
ADD IY.BC 
LD A,(IY+0) 




LD C,A 
LD A,(IY+ 1) 
LD B,A 
PUSH BC 




POP IX 
RET 


DFUNC: 


DEFB 0 


MGSTAB: 


DEFW FNMSGS, 
FNMSG1 


MENU: 


DEFB 0 


FUNC: 


CALL SPPNT 




LD A,(SPX) 




CP 0 




JR Z.FUNC1 



MEMORIZZA X E Y 
;DEL CURSORE 



;USCITA DALLA ROUTINE 
; L’USCITA È LA FUNZIONE 0 
;RIMUOVE L'INDIRIZZO 
*;DI RITORNO 
;RITORNA AL BASIC 
MENÙ 0 0 1 
; I Y PUNTA Al MESSAGGI 
MENÙ DIVENTA 0 0 2 



IY È IY O IY+2 
ORDINE INFERIORE 
DELL’INDIRIZZO DEI MESSAGGI 
IN C 

ORDINE SUPERIORE 
IN B 

PRENDE L'INDIRIZZO 
DELLA TABELLA DEI MESSAGGI 
IN IX 



CONSERVA GLI INDIRIZZI 
DELLE TAVOLE DEI MESSAGGI 
NUMERO DI MENÙ 
CANCELLA IL MESSAGGIO 
DELLA VECCHIA FUNZIONE 
PRENDE LO SPRITE X 
COLONNA DI FUNZIONE 
DESTRA? 

SE È COSÌ STAMPA IL 
MESSAGGIO DELLA FUNZIONE 
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FUNC1: 



FPNT: 

FNPNT1: 



SPPNT: 

MSGFND: 

MSGFN1: 

NOFUNC: 

FNMSGS: 



CP 9 
RET NZ 
LD A, 8 
LD B.A 
LD A,(SPY) 

ADD A,B 
LD B,A 

LD (DFUNC),A 

PUSH BC 
CALL GETMGS 

POP BC 
CALL MSGFND 



;COLONNA SINISTRA? 
;SE NO RETURN 



;GALCOLA E MEMORIZZA 
;IL NUMERO DELLA FUNZIONE 
;SALVA BC 

;PRENDE L’INDIRIZZO 
;DEL MESSAGGIO 
;RIPRISTINA BC 
TROVA IL MESSAGGIO 
.RELATIVO NELLA TABELLA 



LD HL.NAMTAB + 515 
LD A,(IX + 0) 

CP T 
RET Z 

CALL WRTVRM 
INC HL 
INC IX 

JR FNPNT1 ; STAMPA IL MESSAGGIO 

PUSH AF ;ROUTINE STAMPA SPAZI 

LD IX, NOFUNC 
CALL FNPNT 
POP AF 



RET 

DEC B TROVA IL MESSAGGIO B 

;NELLA STRINGA... 

RET M 

LD,(IX + 0) .INDIRIZZATO DA IX 

INC IX 
CP '$' 

JR NZ.MSGFN1 
JR MSGFND 

DEFB ' $’ ;STRINGA FITTIZIA IN 

; ASSENZA DI FUNZIONE 

DEFB ’EXIT$LOAD$SAVE$CLEAR$';MENÙ 1 STRINGA 

;DI MESSAGGIO 

DEFB ’CHARACTER$SPRITE$COLOUR$’ 

DEFB ’SCROLL LEFTSSCROLL RIGHTS' 




FNMSG1: 



ED IT: 



DOFUNC: 



DEFB ’SCROLL UPSSCROLL DOWNS’ 

DEFB ’COPYSINVERTSFLIP VERTICALE 
DEFB ’FLIP HORIZONTALSMENU 2$' 

DEFB ’POSITIONSSWAP BANKSMAGNIFY SPRITES’ 

;MENÙ 2 STRINGA 

DEFB 'DEMAGNIFY SPRITE$16*16 SPRITES’ 

DEFB '8*8 SPRITESNOT IMPLEMENTEDS' 

DEFB ’NOT IMPLEMENTEDSNOT IMPLEMENTEDS’ 
DEFB ’NOT IMPLEMENTEDSNOT IMPLEMENTEDS’ 
DEFB ’NOT IMPLEMENTEDSNOT IMPLEMENTEDS’ 
DEFB ’NOT IMPLEMENTEDSNOT IMPLEMENTEDS’ 
DEFB 'MENU 1$’ 

LD IX.HARRY1 ;IX È IL PUNTATORE AL VETTORE 

LD A,(SPX) 

DEC A 
LD C,A 
LD B ,0 

ADD IX, BC ;SOMMA L’OFFSET DI X 

LD A,(SPY) ;PRENDE L’OFFSET DI Y 

SLA A 



SLA A 
SLA A 
LD C,A 
ADD IX, BC 
LD A,(IX + 0) 
INC A 
AND 1 
LD (IX + 0),A 

RET 
LD A,0 

CALL GTTRIG 

CP 255 
RET NZ 
LD A,(SPX) 

CP 0 ‘ 

JR Z.DOFN1 
CP 9 

JR NZ.EDIT 



;8 VOLTE 

;SOMMA L’OFFSET DI Y 

;INVERTE ALLOCAZIONE 
;DEL VETTORE 

; I L TASTO SPAZIATURA 
;È PREMUTO? 

;SE NO RETURN 



;SE NON È IN UNA COLONNA 
;DI FUNZIONE 



DOFN1: 



LD IX.DFUNC 
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FNTABL: 



NXTMNU: 

NIMP: 

SPRIT: 

CHARF: 

CHAR: 

CHAR1: 



LD A, (MENU) 

SLA A 
SLA A 
SLA A 
SLA A 

ADD A,(IX + 0) 

SLA A 
LD C,A 
LD B,0 

LD IX, FNTABL 
ADD IX, BC 

LD A,(IX + 0) ;PRENDE L’INDIRIZZO 

LD L,A ; DALLA TABELLA DEI SALTI 

LD A,(IX + 1) ; I N 

LD H,A ;HL 

JP (HL) ;E VA AD ESEGUIRE 

DEFW EXIT, LOAD.SAVE.CLR, CHAR, SPRIT 

TABELLA DEI SALTI A FUNZIONE 
DEFW COLR,LSCRL,RSCRL,USCRL 
DEFW DSCRL, COPY, INVT.FVER.FHOR, NXTMNU 
DEFW POSIT.BANKSW.MSP 
DEFW DMSP,SP16,SP8,NIMP, NIMP, NIMP, NIMP 
DEFW NIMP, NIMP, NIMP, NIMP, NIMP, NXTMNU 
LD A, (MENU) ;INVERTE IL MENÙ 

INC A 
AND 1 



LD (MENU), A 
RET 

LD HL.SPTTAB 

LD (CHSP) 

JR CHAR1 

DEFB 0 

LD HL.PATTAB 

LD (CHSP),HL 

CALL GETNUM 
LD (CHARF), A 



ROUTINE FITTIZIA 
ROUTINE DI SCELTA 
DELLO SPRITE 
DA DEFINIRE 
IMPOSTANDO L'INDIRIZZO 
DI SPRITE 
E SELEZIONANDO 
IL CARATTERE 
ROUTINE DI SELEZIONE 
DEL CARATTERE 
INDIRIZZO DI TABELLA 
DEL CARATTERE O SPRITE 
ROUTINE DI INPUT NUMERICO 
MEMORIZZA IL NUMERO 
DI CARATTERE 
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YOBBO: 



GETNUM: 

GN1: 



NUMLOP: 

NUMLAP: 



NUMLLP: 

SGLOP: 



NUMELP: 



CALL TCHAR ;LO PRENDE PER DEFINIRE 

;LA MATRICE 

LD A.0 

CALL GTTRIG 
CP 0 

JR NZ, YOBBO 
RET 

CALL SPPNT ; STAMPA SPAZI 

LD HL.NAMTAB + 519 
CALL NUMLOP 
INC HL 
LD B.A 

CALL NUMLOP 



SLA B 
SLA B 
SLA B 
SLA B 
ADD A,B 

RET 

PUSH HL 
LD C.0 
LD A,0 

CALL GTTRIG 
CP 0 

JR NZ, NUMLAP 
POP HL 
CALL NPNT 
PUSH HL 
LD A,0 

CALL GTSTCK 
CP 0 

JR Z, NUMELP 
INC C 
LD A,C 
CP 16 

JR NZ, NUMELP 
LD C,0 

HALT 

HALT 

HALT 



PRENDE DUE CARATTERI 
NUMERICI ESADECIMALI 
IN A E RETURN 



;ATTESA DI RILASCIO DI SPAZIO 
; STAMPA CIFRA 



;SE IL TASTO DI UN CURSORE 
;È SCHIACCIATO 
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HALT 
LD A,0 


ASPETTA UN BIT 




CALL GTTRIG 
CP 255 


FINITO PER CIFRA CORRENTE? 




JR NZ.UMLLP 


SE NO FALLO ANCORA 




POP HL 


ALTRIMENTI RIPRISTINA HL 




LD A,C 


DIGITALE IN A 




RET 


RETURN 


NPNT: 


LD A,C 


NUMERO IN A 




ADD A, 48 


CONVERTE IN CODICE ASCII 




CP 58 

JR C.NPNT2 


SE ESADECIMALE DA A AD F 




ADD A, 7 


ALLORA CONVERTE 
ULTERIORMENTE IN ASCII 


NPNT2: 


CALL WRTVRM 
RET 


LO STAMPA 


TCHAR: 


LD A.(CHARF) 


QUESTA ROUTINE 
TRASFERISCE 




LD L,A 


LA DEFINIZIONE IN VRAM 
DEL CARATTERE OPPURE 




LD H,0 

ADD HL.HL 
ADD HL,HL 
ADD HL,HL 
PUSH HL 
POP DE 
LD IX,(CHSP) 
ADD IX, DE 
PUSH IX 
POP HL 
LD C,8 

LD IY.HARRY1 


DELLO SPRITE NELLA MATRICE 
DI DEFINIZIONE 


TCOLP: 


LD B,8 

CALL RDVRM 




TCILP: 


LD D,0 






RLC A 


SPOSTA 1 BIT DI DEFINIZIONE 




JR NC, TCSKP 


NEL CARRY 




LD D,1 


E SCRIVE 0 E 1 


TCSKP: 


LD (IY+0),D 


NEL VETTORE DOVE 
NECESSARIO 




INC IY 


INCREMENTA IL PUNTATORE 
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DJNZ TCILP 


AL VETTORE 
E RIPETE 




INC HL 


INCREMENTA IL PUNTATORE 




DEC C 

JR NZ.TCOLP 


ALLA VRAM 
E LO FA PER 8 RIGHE 


CHSP: 


RET 

DEFW PATTAB 




CHART: 


LD A,(CHARF) 


QUESTA ROUTINE È 




LD L,A 


L'INVERSO 




LD H,0 


DI QUELLA PRECEDENTE 




ADD HL.HL 
ADD HL,HL 
ADD HL,HL 
PUSH HL 
POP DE 
LD IX, (CHSP) 
ADD IX, DE 
PUSH IX 
POP HL 




CTLO: 


LD C,8 

LD IY,HARRY1 
XOR A 




CTLI: 


LD D,A 
LD B,8 
LD A,(IY+Ó) 




CLR: 


CP1 
CCF 
RL D 
INC IY 
DJNZ CTLI 
LD A,D 

CALL WRTVRM 
INC HL 
DEC C 
JR NZ.CTLO 
RET 

LD IX.HARRY1 


ROUTINE CHE CANCELLA 




LD B,64 


LA MATRICE 
VETTORE DI 64 BYTE 




LD A,0 


0 CANCELLA 


CLRLP: 


LD (IX + 0),A 


LA MATRICE 
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INVT: 

IVTLP: 

POSIT: 



INC IX 

DJNZ CLRLP 
RET 

LD IX.HARRY1 

LD B,64 
LD A,(IX + 0) 

INC A 
AND 1 
LD (IX + 0).A 
INC IX 
DJNZ IVTLP 
RET 

CALL CURPOS 
LD HL.(CHSP) 
XOR A 

LD DE.PATTAB 

SBC HL.DE 

JR NZ.SPOSIT 

LD A,(CYP) 
AND 0F8H 
SLA A 
SLA A 



LD B,A 
LD A,(CXP) 

SRL A 
SRL A 
SRL A 
ADD A,B 
LD HL.NAMTAB 
LD E, A 
LD D,0 
ADD HL,DE 



; INCREMENTA IL PUNTATORE 
ALLA MATRICE 
64 VOLTE 
RETURN 

IX È IL PUNTATORE 
ALLA MATRICE 

LA MATRICE È LUNGA 64 BYTE 
PRENDE I CONTENUTI 
DELLA MATRICE 
0 DIVENTA 1 
E 1 DIVENTA 0 
LO RIMETTE A POSTO 
INCREMENTA IL PUNTATORE 
LO FA 64 VOLTE 

POSIZIONE DEL CURSORE 
CARATTERE 0 SPRITE? 
CANCELLA A E IL FLAG 
DI RIPORTO 

INDIRIZZO DELLA TABELLA 
DI GEN. DEI MODELLI 
STIAMO FACENDO 
UN CARATTERE? 

NO, VAI A POSIZIONARE 
LO SPRITE 



; DI VI DE PER 8 X E Y 
;DEL CURSORE 



;CALCOLA L'INDIRIZZO 
;DELLA TABELLA DEI NOMI 
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LD A,(CHARF) 




SPOSIT: 

SPOSTO: 

SPOSTI: 



SPCOL: 

CHCOL: 

CXP: 

CYP: 

CURPOS: 

CUPI: 

CUPOLP: 



CALL WRTVRM 
RET 

LD HL.SATTAB 

LD A.(CHARF) 
AND 31 
LD B,A 
INC HL 
INC HL 
INC HL 
INC HL 
DJNZ SPOSTO 
LD A, (CYP) 
CALL WRTVRM 
INC HL 
LD A, (CXP) 
CALL WRTVRM 



;E SCRIVE IL CARATTERE 
;CORRENTE 

ROUTINE CHE POSIZIONA 
;SPRITE 

INUMERÒ DI SPRITE 
:MOD 32 



.PIANO DI SPRITE DA USARE 



INC HL 
LD A.(CHARF) 

CALL WRTVRM 
LD A, (SPCOL) 

INC HL 

CALL WRTVRM '.SCRIVE GLI ATTRIBUTI 

;DI SPRITE 

RET 

DEFB 3 ;MEMORIZZA I COLORI 

;DI SPRITE 

DEFB 31H,31H,31H,31H,31H,31H,31H,31H 

.COLORI CARATTERISTICI 



POSIZIONE DI PARTENZA PER... 
; POSIZIONARE IL CURSORE 



;ABBIAMO LIBERATO 
;IL TASTO SPAZIATURA 

;PRENDE LE COORDINATE X, Y 
;DEL CURSORE 



DEFB 0 
DEFB 0 
LD A, 16 
LD (CXP), A 
LD (CYP), A 
LD A.O 

CALE GTTRIG 
CP 255 
JR Z.CUP1 
LD HL.(CXP) 



LD A.O 
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PUSH HL 
CALL GTSTCK 
POP HL 
CP 1 

JR NZ.CUP2 
DEC H 

CUP2: CP 3 

JR NZ.CUP3 
INC L 

CUP3: CP 5 

JR NZ.CUP4 
INC H 

CUP4: CP 7 

JR NZ.CUP5 
DEC L 

CUP5: LD A,H 

CP 57 
JR C.CUP6 
LD H,0 

CUP6: LD (CXP).HL 

LD HL.SATTAB 
LD A,(CYP) 
CALL WRTVRM 
INC HL 
LD A,(CXP) 
CALL WRTVRM 
INC HL 
INC HL 
LD A, 12 

CALL WRTVRM 

LD A,0 
PUSH HL 
CALL GTTRIG 
POP HL 
HALT 
HALT 
HALT 
HALT 
CP 0 

JR Z.CUPOLP 
RET 



;MUOVE IL CURSORE 



ISCRIVE LA NUOVA POSIZIONE 
; D I SPRITE 



;ABBIAMO FINITO I MOVIMENTI? 



;SE NO MUOVERE ANCORA 
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CSPT: 


LD B,20 






LD HL.NAMTAB + 547 




CSPTO: 


LD A,32 
CALL WRTVRM 
INC HL 
DJNZ CSPTO 
LD HL.(CHSP) 






LD DE.PATTAB 


;QUESTA ROUTINE STAMPA... 




LD IX, CMESS 


TUTTO LO SPAZIO RIMANENTE 




SBC HL.DE 
JR Z.CSPT1 
LD IX, SMESS 


;ED IL MESSAGGIO 


CGPT1: 


LD HL,NAMTAB + 547 




CSPT2: 


LD A,(IX + 0) 

CP 

JR Z.CSPT3 
CALL WRTVRM 
INC HL 
INC IX 
JR CSPT2 




CSPT3: 


LD A,(CHARF) 
SRL A 
SRL A 
SRL A 
SRL A 
LD C,A 
CALL NPNT 
INC HL 
LD A,(CHARF) 
AND 15 
LD C,A 






CALL NPNT 


;QUESTE ROUTINE 
;MANTENGONO... 




RET 


;AGGIORNATA LAREA STATUS. 


CMESS: 


DEFB ’CHAR:$' 


;DELLO SCHERMO 


SMESS: 


DEFB ’SPRITE:$' 




COLMES: 


DEFB ’SPRITECOL:$' 




COLMS1: 


DEFB ’CHARCOLSS' 




COLPT: 


LD HL.NAMTAB + 579 
LD IX, COLMES 




COLPT1: 


LD A,(IX + 0) 
CP '$’ 
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JR Z.C0LPT2 
CALL WRTVRM 
INC HL 
INC IX 
JR C0LPT1 

C0LPT2: LD A.(SPCOL) 

SRL A 
SRL A 
SRL A 
SRL A 

LD (SPCOL),A 
CALL NPNT 
LD A,(SPCOL) 

AND 15 

LD C,A 

INC HL 

CALL NPNT 

LD HL.NAMTAB + 532 

LD IX.COLMS1 

COLPT3: LD A,(IX + 0) 

CP ’$' 

JR Z.COLPT4 
CALL WRTVRM 
INC HL 
INC IX 
JR COLPT3 

COLPT4: INC HL 

PUSH HL 
LD A,(CHARF) 

LD L,A 
LD H,0 
ADD HL,HL 
ADD HL,HL 
ADD HL,HL 
PUSH HL 
POP DE 
LD IX.COLTAB 
ADD IX, DE 
PUSH IX 
POP HL 
LD IX,CHCOL 
LD B,8 
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C0LPT5: CALL RDVRM 

LD (IX + 0), A 
INC IX 
INC HL 
DJNZ COLPT5 
POP HL 
LD B,8 
LD DE, 31 
LD IX.CHCOL 
COLPT6: LD A,(IX + 0) 

PUSH AF 
SRL A 
SRL A 
SRL A 
SRL A 
LD C.A 
CALL NPNT 
POP AF 
AND 15 
INC HL 
LD C,A 
CALL NPNT 
ADD HL.DE 
INC IX 

DJNZ COLPT6 
RET 

BANK: DEFB 0 

BPMESS: DEFB 'BANK’ 

BANKPT: LD HL.NAMTAB + 611 

LD IX, BPMESS 
BKPT1: LD A.(IX + 0) 

CP ■$• 

JR Z.BKPT2 
CALL WRTVRM 
INC HL 
INC IX 
JR BKPT1 

BKPT2: LD A, (BANK) 

AND 15 
LD C,A 
CALL NPNT 
RET 
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FTTXRM: 



SPTXRM: 



LPTXRM: 



COLR: 



LD H L, PATTAB 
LD DE.0B000H 
LD BC.1800H 
CALL LDIRMV 
LD HL.COLTAB 
LD DE.0C800H 
LD BC.1800H 
CALL LDIRMV 
LD HL.SPTTAB 
LD DE,0E000H 
LD BC.800H 
CALL LDIRMV 
RET 

LD A,(BANK) 
LD H,A 
LD L.O 
ADD HL.HL 
ADD HL.HL 
ADD HL,HL 
PUSH HL 
LD DE.OBOOOH 
ADD HL,DE 
EX DE.HL 
LD HL, PATTAB 
LD BC.800H 
CALL LDIRMV 
POP HL 
LD DE.0C800H 
ADD HL.DE 
EX DE.HL 
LD HL.COLTAB 
LD BC.800H 
CALL LDIRMV 
JR SPTXRM 
CALL SPPNT 
LD A,0 

CALL GTTRIG 
CP 255 
JR Z.COLR 
LD HL,(CHSP) 
XOR A 

LD DE, PATTAB 
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COLLYP: 



HNGON1: 



HANGON: 



SBC HL.DE 
JR NZ.COLSP 
LD IX.CHCOL 
LD B,8 

LD A,8 
SUB B 
ADD A, 48 
PUSH BC 

LD HL,NAMTAB + 517 
CALL WRTVRM 
INC HL 
LD A,’:' 

CALL WRTVRM 
INC HL 
LD A,(IX+0) 

SRL A 
SRL A 
SRL A 
SRL A 
LD C,A 
LD A,0 

CALL GTTRIG 
CP 255 
JR Z,HNGONl 
PUSH IX 
CALL SGLOP 
POP IX 
SLA A 
SLA A 
SLA A 
SLA A 
LD B,A 
LD A,(IX + 0) 

AND 15 
OR B 

LD (IX + 0)A 
AMO 15 
LD CA 
INC HL 
LD A.O 

CALL GTTRIG 
CP 255 




JR Z.HANGON 
PUSH IX 
CALL SGLOP 
POP IX 
AND 15 
LD B.A 
LD A, (IX 4-0) 
AND OFOH 
OR B 

LD (IX + 0) t A 
INC IX 
POP BC 
DJNZ COLLYP 
LD A,(CHARF) 
LD L,A 
LD H,0 
ADD HL.HL 
ADD HL.HL 
ADD HL,HL 
LD DE.COLTAB 
ADD HL.DE 
EX DE.HL 
LD HL.CHCOL 
LD BC,8 
CALL LDIRVM 
RET 

COLSP: CALL GETNUM 

LD (SPCOL),A 
RET 

DMSP: LD A, (9001 H) 

OR 1 

LD (9001 H), A 
LD B,A 
LD C,1 

CALL WRTVRM 
RET 

MSP: LD A, (9001 H) 

AND OFEH 
LD (9001 H), A 
LD B,A 
LD C,1 



PRENDE IL VALORE ATTUALE 
DI VDP(1) 

PONE A 1 IL FLAG MAG 
LO RIMETTE A POSTO 



;LO SCRIVE NEL VDP 



;RIMETTE A POSTO IL FLAG MAG 
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SP8: 



SP16: 



LSCRL: 



LSLP: 



LSLP1: 



LSLP2: 



CALL WRTVDP 
RET 

LD A, (9001 H) 
AND OFDH 

LD (9001 H), A 
LD B.A 
LD C.1 

CALL WRTVDP 
RET 

LD A, (9001 H) 
OR 2 

LD (9001H),A 
LD B,A 
LD C,1 

CALL WRTVDP 
RET 

LD IX.HARRY1 

LD IY.HARRY2 
LD C,8 
LD A,(IX + 0) 

LD (IY+7).A 
LD B.7 
INC IX 
LD A,(IX + 0) 

LD (IY+0),A 
INC IX 
INC IY 
DJNZ LSLP1 
INC IY 
DEC C 
JR NZ.LSLP 
LD IX.HARRY1 

LD l^,HARRY2 
LD B,64 
LD A,(IY+0) 

LD (IX + 0), A 
INC IX 
INC IY 



;L0 SCRIVE IN VDP 

;PONE A 0 FLAG DI SPRITE 
;16 * 16 

;E LO SCRIVE NEL VDP 

;PONE A 1 FLAG DI SPRITE 
;16 * 16 



;E LO SCRIVE NEL VDP 

; SPOSTA A SINISTRA 
;DAL VETTORE 1 
;AL VETTORE 2 



;METTE IL VETTORE 2 
;NEL VETTORE 1 
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LSLP3: 



RSCRL: 

RSCRLP: 



USCRL: 



USRLP1: 



USRLP2: 



USRLP3: 



DJNZ LSLP2 
LD A,0 

CALL GTTRIG 

CP 255 
JR Z.LSLP3 
RET 
LD B,7 
PUSH BC 
CALL LSCRL 
POP BC 
DJNZ RSCRLP 
RET. 

LD DE, 8 

LD IX,HARRY1 
LD IY.HARRY2 
LD C.8 
PUSH IX 
PUSH IY 
LD A,(IX + 0) 
LD (IY+56),A 
ADD IX, DE 
LD B.7 
LD A,(IX + 0) 
LD (IY+0),A 
ADD. IX, DE 
ADD IY.DE 
DJNZ USRLP2 
POP IY 
POP IX 
INC IY 
INC IX 
DEC C 

JR NZ.USRLP1 
LD IX.HARRY1 
LD IY.HARRY2 
LD B,64 
LD A.(IY+0) 

LD (IX + 0),A 
INC IX 
INC IY 



;64 BYTE? 

; ASPETTA CHE SI LIBERI 
;IL TASTO SPAZIATURA 



SPOSTAMENTO IN ALTO 
È SIMILE... 

A SPOSTAMENTO SINISTRO 
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DJNZ USRLP3 
USRLP4: LD A,0 

CALL GTTRIG 
CP 255 
JR Z.USRLP4 
RET 

DSCRL: LD B,7 

DCRLP: PUSH BC 

CALL USCRL 
POP BC 
DJNZ DCRLP 
RET 

FVER: LD IX.HARRY1 

LD IY,HARRY2 + 56 
LD C,8 
LD DE, 8 
FVER1: PUSH IX 

PUSH IY 
LD B,8 

FVER2: LD A,(IX + 0) 

LD (IY+0),A 
INC IX 
INC IY 

DJNZ FVER2 
POP HL 
XOR A 
SBC HL,DE 
PUSH HL 
POP IY 
POP IX 
ADD IX, DE 
DEC C 

JR NZ.FVER1 
LD B,64 
LD IX.HARRY1 

LD IY.HARRY2 
FVER3: LD A,(IY+0) 

LD (IX + 0),A 
INC IX 



;SPOSTAMENTO VERSO 
; I L BASSO 

;7 VOLTE 



RIFLESSIONE VERTICALE 
DAL VETTORE 1 
AL VETTORE 2 



RIPORTA POI IL VETTORE 2 
MODIFICATO... 

NEL VETTORE 1 
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FHOR: 

FH0R1: 

FHOR2: 

FHOR3: 

BANKSW: 

BSW1: 



INC IY 
DJNZ FVER3 
JP USRLP4 

LD IX.HARRY1 ;LA RIFLESSIONE 

;ORIZZONTALE... 

LD IY.HARRY2 + 7 ;È SIMILE A QUELLA VERTICALE 

LD C,8 

PUSH IY 

LD DE, 8 

LD B,8 

LD A,(IX + 0) 

LD (IY+0),A 
INC IX 
DEC IY 
DJNZ FHOR2 
POP IY 
XOR A 
ADD IY,DE 
DEC C 

JR NZ.FHOR1 
LD B,64 
LD IX.HARRY1 
LD IY.HARRY2 
LD A,(IY+0) 

LD (IX + 0),A 
INC IX 
INC IY 

DJNZ FHOR3 
JP USRL4 
CALL SPPNT 
LD HL.NAMTAB + 157 
CALL NUMLOP 
CP 3 

JR NC, BANKSW 
LD (BANK), A 
LD BC,800H 
LD DE.OBOOOH 
LD FI, A 
LD L,0 
ADD HL.HL 
ADD HL.HL 
ADD HL,HL 
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PUSH HL 
LD HL,DE 
LD DE.PATTAB 
CALL LDIRVM 
POP HL 
LD DE,0C800H 
ADD HL,DE 
LD DE.COLTAB 
LD BC,800H 
CALL LDIRVM 
CALL TCHAR 
RET 




COPBNK: 


DEFB 0 




COPCHA: 


DEFB 0 




COPY: 


CALL SPPNT 


-.ROUTINE CHE COPIA 
;UNA DEFINIZIONE 




LD IX.BPMESS 
LD HL.NAMTAB + 517 




COPYLP: 


LD A, (IX 4-0) 

CP ’$' 

JR Z.COPY1 
CALL WRTVRM 
INC HL 
INC IX 
JR COPYLP 


;STAMPA MESSAGGI 


COPY1: 


CALL NUMLOP 


;PRENDE IL NUMERO DI BANCO 




LD (COPBNK), A 


; SALVA IL BANCO DA COPIARE 




CALL GETNUM 


;PRENDE IL NUMERO 
;DI CARATTERE/SPRITE 




LD (COPCHA), A 
LD A, (COPBNK) 
CP 4 


* 




JR NC.COPY 
CP 3 

JP Z.SPCOPY 
LD A^COPCHA) 
LD L,A 

LD A, (COPBNK) 
LD H,A 
ADD HL.HL 
ADD HL.HL 


;COPIA CARATTERI 0 SPRITE 
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ADD HL,HL 

PUSH HL 
LD DE.OBOOOH 
ADD HL,DE 
PUSH HL 
LD A.(CHARF) 
LD L,A 
LD H,0 
ADD HL.HL 
ADD HL,HL 
ADD HL,HL 
LD DE,(CHSP) 
ADD HL.DE 
EX DE,HL 

POP HL 
LD BC,8 
CALL LDIRVM 

POP BC 
LD DE,(CHSP) 
LD HL.PATTAB 
XOR A 
SBC HL,DE 
JR NZ.COPSKP 
PUSH BC 
POP HL 
LD DE,0C800H 

ADD HL.DE 
PUSH HL 
LD DE.COLTAB 
LD A.(CHARF) 
LD L,A 
LD H,0 
ADD HL.HL 
ADD HL.HL 
ADD HL.HL 
ADD HL.HL 
EX DE.HL 
POP HL 



;CALCOLA L'INDIRIZZO 
;DEL CARATTERE 



;NELLA RAM 



;PRENDE L’INDIRIZZO IN VRAM 
;DEL CARATTERE O DELLO SPRITE 



;LO TRASFERISCE DALLA RAM 
;ALLA VRAM 



;SE STA TRASFERENDO 
;UN CARATTERE 
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COPSKP: 

SPCOPY: 



LOAD: 

LI: 

L2: 



LD BC,8 
CALL LDIRVM 

CALL TCHAR 

RET 

LD A,(COPCHA) 

LD L.A 
LD H,0 
ADD HL.HL 
ADD HL.HL 
ADD HL.HL 
LD DE.0E000H 
ADD HL,DE 
PUSH HL 
LD A,(CHARF) 

LD L.A 
LD H.O 
ADD HL.HL 
ADD HL.HL 
ADD HL.HL 
LD DE.(CHSP) 
ADD HL.DE 
EX DE.HL 
POP HL 
LD BC,8 
CALL LDIRVM 
CALL TCHAR 
RET 
LD A.1 

LD (BASFNC).A 
POP HL 

LD HL.L2 

LD (RTADDR).HL 
RET 

LD A, (BANK) 
CALL GTX 
CALL TCHAR 
JP NDFNC 



PRENDE ELEMENTO 
DELLA TABELLA DEI COLORI 
METTE IL CARATTERE 
NELLA MATRICE 



;SUBROUTINE CHE COPIA 
;SPRITE 



;LOAD È LA FUNZIONE BASIC 1 

;PRENDE L'INDIRIZZO 

;DI RITORNO DALLO STACK 

;PRENDE IL NUOVO INDIRIZZO 

;DI RIENTRO 

;LO SALVA PER IL BASIC 

;AL BASIC 
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SAVE: LD A, 2 

JR LI 

GTX: LD HL.OBOOOH 

LD DE.PATTAB 
LD BC.1800H 
CALL LDIRVM 
LD HL.0C800H 
LD DE.COLTAB 
LD BC,1800H 
CALL LDIRVM 
LD HL.OEOOOH 
LD DE.SPTTAB 
LD BC,800H 
CALL LDIRVM 
RET 

BASFNC: DEFB 0 

RTADDR: DEFW 0 

END 



;SAVE È LA FUNZIONE BASIC 2 
;VA ALLA ROUTINE LO AD 



MEMORIZZA IL NUMERO 
DI FUNZIONE 
E L’INDIRIZZO DI RITORNO 
PER IL BASIC 



Il programma riportato deve essere assemblato e salvato su nastro con no- 
me ’GM2’. Si digiti ora il programma BASIC che segue e lo si salvi a sua 
volta su nastro. Questo programma ha la funzione di caricare e far esegui- 
re il codice macchina. 

10 CLEAR 200.&H8FFFF 
20 PRINT “LOADING..." 

30 BLOAD‘‘CAS:GM2" 

40 DEFUSR = &H9008 
50 A= USR(A) 

60 DEFUSR = PEEK(&H9AED) + 256*(PEEK(&H9AEE)):REM RTADDR 
70 IF PEEK(&H9AEC) = 0 THEN SCREEN1,0,0,1:END 
80 IF PEEK(&H9AEC) = 1 THEN BLOAD"CAS:CHARS'' 

90 IF PEEK(&H9AEC) = 2 THEN BSAVE‘'CAS:CHARS“,&HB000,&HE801 
100 GOTO 50 

Uso del programma definitore 

Quando manderete in esecuzione il programma vi accorgerete che lo scher- 
mo è diviso in tre zone. La zona più alta è nera, la zona intermedia contie- 
ne una griglia di 10 * 8 elementi (le cui colonne estreme di destra e sinistra 
sono segnate con una linea di piccole croci) e nella terza zona vengono vi- 
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sualizzate le funzioni che il programma è in grado di svolgere. Muovendo 
il cursore sulle colonne della griglia contenute nella seconda zona vedrete 
apparire dei messaggi sotto la griglia, nella terza sezione dello schermo. 
Il movimento del cursore avviene per mezzo dei tasti di controllo del cur- 
sore stesso, mentre la barra di spaziatura ha una doppia funzione: quando 
il cursore si trova nella parte centrale (8 * 8) della matrice di definizione, 
la pressione della barra di spaziatura comporta il cambiamento di stato della 
posizione in cui si trova il cursore. Quando il cursore è invece in una delle 
colonne riservate alle funzioni, la pressione della barra di spaziatura pro- 
voca l’attivazione della funzione stessa, scelta tra quelle visualizzate sotto 
la matrice di definizione. 

Oltre ai messaggi delle funzioni, la terza parte dello schermo, quella infe- 
riore, viene utilizzata anche per alcuni messaggi di stato, la maggior parte 
dei quali sono autoesplicativi. 

Le funzioni che il programma può svolgere sono le seguenti: 



EXIT 

LOAD 



SAVE 

CLEAR 

CHARACTER 



SPRITE 

COLOUR 



SCROLL LEFT 
R1GHT 
UP 

DOWN 

COPY 

INVERT 

FLIP 

HORIZONTAL 
VERTICAL 
MENU 1/2 



Termina il programma. 

Carica da nastro un file chiamato “CHARS” che con- 
tiene la definizione dei caratteri, quella degli sprite 
e i colori dei caratteri. 

Salva il file “CHARS” su nastro. 

Azzera la matrice di definizione. 

Seleziona il carattere che deve essere modificato e tra- 
sferisce la sua definizione dalla VRAM alla matrice 
di definizione. 

Seleziona lo sprite che deve essere definito. 

In fase di definizione di u,n carattere, questa funzio- 
ne consente di definire il suo colore riga per riga. In 
fase di definizione di uno sprite imposta il colore per 
la funzione POSITION. 

Sposta la definizione corrente sulla matrice nella di- 
rezione indicata; le parti che scompiaiono sulla de- 
stra ricompaiono sulla sinistra e viceversa (analoga- 
mente per l’alto e il basso). 

Copia una definizione di carattere o di sprite in quella 
corrente. 

Cambia Io stato di tutti i pixel della definizione cor- 
rente. 

Produce una definizione speculare di quella corren- 
te rispetto a una linea (orizzontale o verticale) che pas- 
sa per il centro della matrice. 

Scambia i menù di funzioni accessibili partendo dal- 
le colonne riservate alle funzioni. 
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POSITION 
SWAP BANK 



MAGNIFY 

DEMAGNIFY 

SPRITES 

8*8/16*16 SPRITES 



Consente di posizionare caratteri e sprite nella parte 
superiore dello schermo. 

Come abbiamo visto in precedenza, la tabella dei mo- 
delli nella modalità Grafica li consiste di tre insiemi 
di 256 definizioni ciascuna. Il numero di banco de- 
termina a quale di questi tre insiemi appartengono 
i caratteri che si stanno definendo e quelli che com- 
paiono sullo schermo (si noti che quando viene chie- 
sto il numero di banco nella funzione COPY, i nu- 
meri da 0 a 2 indicano i caratteri, il 3 la definizione 
degli sprite). 



Queste due funzioni impostano i registri dei VDP de- 
terminando il fattore di ingrandimento degli sprite. 



Un input numerico viene sempre considerato sotto forma di numero esa- 
decimale di due cifre. Le cifre vengono selezionate dal cursore; quella più 
significativa precede quella di ordine inferiore. 

Le definizioni dei caratteri, al termine del programma, vengono lasciate nella 
RAM della CPU nelle seguenti locazioni: 

Da 0B000H a 0C800H: la tabella di generazione dei modelli 

(la definizione dei caratteri). 

Da 0C800H a 0E000H: la tabella dei colori. 

Da 0E000H a 0E800H: le definizioni degli sprite. 

Il definitore nella altre modalità video 

Nella modalità Grafica I vi sono solo 256 possibili definizioni di caratteri 
e quindi è necessaria la definizione solo del primo “banco”. Esso risiederà 
quindi dalla locazione OBOOOH alla 0B800H (la tabella dei colori può esse- 
re trascurata); le definizioni degli sprite restano attive. 

Se si usa il definitore nella modalità testo rimangono valide le osservazioni 
fatte, con l’eccezione che, non essendo possibile il loro utilizzo, le defini- 
zioni degli sprite risultano irrilevanti. Va ricordato che nella modalità testo 
vengono usate solo le 6 colonne più a sinistra: è quindi consigliabile lascia- 
re in bianco le altre due colonne di ogni definizione. 

Definizione dinamica di modelli 



Poiché il VDP tiene nella VRAM tutte le definizioni dei caratteri, è possi- 
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bile ottenere una sorta di animazione nel piano dei modelli ridefinendo i 
caratteri durante l’esecuzione del programma. Quando viene fatto ciò, si 
può notare che la nuova definizione viene applicata a tutte le occorrenze 
del carattere che si è modificato. In questo modo è possibile modificare 
ampie zone dello schermo variando un numero relativamente piccolo di 
elementi della tabella di generazione dei modelli. Consideriamo, a titolo 
esemplificativo, la definizione del disegno di una scala a pioli largo 7 ca- 
ratteri e alto 1. Esso apparirà simile ad un elevatore con gli elementi mobili 
che si spostano dal basso verso l’alto: questo effetto può essere ottenuto 
agendo su un solo carattere. 

Prima di tutto definiamo il carattere di base. Per ottenere il disegno che 
ci prefiggiamo, abbiamo bisogno di un carattere che sia come un pezzo della 
scala; quest’ultima verrà poi ottenuta “impilando” più caratteri come quello 
che stiamo definendo. Ad esempio può andar bene il seguente modello: 

10000001 81 H 

11111111 FFH 
10000001 81 H 

10000001 81 H 

10000001 81 H 

11111111 FFH 
10000001 81 H 

10000001 81 H 



Dopo aver deciso il modello del carattere, è necessario scriverlo nella VRAM: 
lo facciamo indicandolo come carattere 0. 



CHRDEF: DEFB 081H.0FFH.081H.081H.081H.0FFH.081H.081H 



CHARIN: LD B,8 

LD IX, CHRDEF 
LD HL.PGTAB 

CILP: LD A,(IX + 0) 

CALL 004 DH 
INC HL 
INC IX 
DJNZ CILP 
RET 



INUMERÒ DEGLI ELEMENTI 
;1N CHRDEF 
;PORTA L’INDIRIZZO 
;DELLA DEFINIZIONE IN IX 
;PORTA IN HL L’INDIRIZZO 
;DELLA TABELLA DI GEN. MOD. 
.PRENDE UN BYTE DATO 
ISCRIVE (HL) NELLA VRAM 

lINCREMENTA I PUNTATORI 
;LO FA 8 VOLTE 



Abbiamo ora nella VRAM una definizione che possiamo variare per otte- 
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nere l’effetto desiderato. La manipolazione richiesta è uno spostamento ver- 
ticale degli otto byte della definizione del carattere, facendo ricomparire 
in basso la riga che esce, “sospinta” dalle altre, dall’alto. La routine che 
segue ottiene quanto detto: 



RDVRM EQU 004AH 
WRTVRM EQU 004DH 
DSCROL: LD B,7 

LD HL.PGTAB 

CALL RDVRM 
LD C,A 
DSCLP: INC HL 

CALL RDVRM 

DEC HL 
CALL WRTVRM 
INC HL 

DJNZ DSCLP 
LD A,C 

CALL WRTVRM 
RET 



IMPOSTA IL CONTATORE 
DEL CICLO 

IMPOSTA L’IND. DI VRAM 
DELLA DEFINIZIONE 
LEGGE IL PRIMO VALORE 
LO SALVA PER DOPO 
INCREMENTA IL PUNTATORE 
IN VRAM 

LEGGE UNA LINEA 
DELLA DEFINIZIONE 
E LA MEMORIZZA UNA 
POSIZIONE PIÙ IN ALTO 
RIMPOSTA IL PUNTATORE 
IN VRAM 
LO FA 7 VOLTE 
LA VECCHIA PRIMA LINEA 
DIVENTA QUELLA DI FONDO 



Chiamando questa procedura più volte la nostra scala sembrerà avere un 
movimento verticale, dal basso verso l’alto, dei pioli. Possono essere co- 
struiti disegni di scale di qualunque dimensione; è necessario anche il se- 
guente programma: 



START: CALL CHARIN 

LD HL.NAMTAB + 8 

LD DE, 32 
LD B,7 

PLOOP: CALL WRTVRM 

ADD HL,DE 

DJNZ PLOOP 



DEFINISCE IL CARATTERE 
CHIAMANDO LA ROUTINE 
PRECEDENTE 
PRENDE L’INDIRIZZO 
DELLA TAB. NOMI + 8 
LUNGHEZZA DI LINEA IN DE 
LA SCALA È LUNGA 
7 CARATTERI 

STAMPA IL CARATTERE SCALA 
DECREMENTA DI 1 
LA POSIZIONE DI STAMPA 
LO FA PER 7 CARATTERI 
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L00P2: 



; SPOSTA LA DEFINIZIONE 



CALL DSCROL 
HALT 

HALT ;PAUSA DI 2/50 DI SECONDO 

JR LOOP2 ;LO FA NUOVAMENTE 

Come abbiamo potuto capire da questo esempio, il principio della defini- 
zione dinamica dei caratteri è uno strumento molto potente: il suo utilizzo 
è limitato solo dall’immaginazione. Infatti è il principio della definizione 
dinamica dei caratteri che ci consente di considerare (nella prossima sezio- 
ne) la modalità Grafica II come una modalità “bit mapped”. 



La modalità Grafica II come modalità “bit mapped” 



Se nella modalità Grafica II impostiamo la tabella dei nomi in modo che 
i 768 byte della tabella vengano numerati consecutivamente da 0 a 255 per 
tre volte, ne consegue che ogni singola posizione carattere ha una sua pro- 
pria ed unica definizione nella tabella di generazione dei modelli, e questa 
situazione può essere considerata essere “bit mapped”, così come mostra 
la figura 6.1. Avendo preparato la tabella dei nomi nel modo suddetto ora 
disponiamo, a tutti gli effetti, di una modalità ad alta risoluzione con 256 
* 192 pixels e con la possibilità di 15 colori (sebbene disgraziatamente la 
risoluzione orizzontale del colore è di solo 32 blocchi di otto pixel). 

Se consideriamo come origine l’angolo in basso a destra, la formula che 
permette di calcolare quale byte nella tabella di generazione dei modelli con- 
tiene il pixel puntato dalle coordinate X e Y è la seguente: 

(Indirizzo inizio della tabella di generazione dei modelli) + ((((191 — Y)div 
8 j*256) + ((191— Y)mod 8) + (X AND 0F8H)) 

e il bit che deve essere posto a 1 all’interno del byte può essere individuato 
con: 

7— (X AND 7) 

Facendo uso delle suddette formule, la procedura che viene riportata di se- 
guito serve per impostare il pixel le cui coordinate sono in HL (L contiene 
la coordinata X, mentre H la coordinata Y) con il colore specificato dal- 
l’accumulatore: ^ 



SETXY: PUSH AF 

LD A, 191 
SUB H 
LD H,A 



SALVA IL CODICE DEL COLORE 
PONE Y UGUALE A... 

191 — Y 

LO RIMETTE IN H 
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PUSH HL 
SRL H 
SRL H 
SRL H 
LD D,H 
POP HL 
LD A,H 
AND 7 
LD E, A 
XOR A 

LD A,L 
AND 0F8H 
LD E, A 
LD A.O 
ADC A,D 
LD D.A 



LD B,L 

LD HL.COLTAB 

ADD HL,DE 
CALL 004 AH 

AND 15 
LD C.A 
POP AF 
SLA A 
SLA A 
SLA A 
SLA A 
ADD A,C 

ALL 004 DH 
LD A.7 
AND B 
LD B,A 
XOR A 
INC B 
CCF 



; SALVA X,Y 



;Y DIVENTA Y DIV 8 

;RECUPERA XY 
.PRENDE Y 
;MOD 8 

;PULISCE IL FLAG DI CARRY 
;PER ADDIZIONE 16 BIT 
;PRENDE X 

;LO SOMMA A DE 

TERMINA ADDIZIONE 16 BIT 
;DE CONTIENE ORA L'OFFSET 
; DALLA TAB. GEN. MODELLI, 

;E L’INDIRIZZO BASE 
;DELLA TABELLA DEI COLORI. 
.SALVA X 

;PRENDE LA BASE DELLA TAB. 
.COLORI 

;SOMMA L'OFFSET 
;PRENDE IL VALORE CORRENTE 
;DI COLORE 

; MASCHERA LO SFONDO 
;LO SALVA IN C 
;RIPRISTINA IL COLORE 
;SHIFT DEL CODICE COLORE 



NEL SEMIBYTE ALTO 
SOMMA IL COLORE DELLO 
SFONDO 
E LO RISCRIVE 
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MLP: 



RRA 

DJNZ MLP 
LD HL.PGTAB 

ADD HL.DE 
CALL 004AH 
XOR B 
CALL 004 DH 
RET 



;IND. TAB. GENERAZIONE 
MODELLI IN HL 
SOMMA L'OFFSET 
LEGGE IL VECCHIO VALORE 
MASCHERA LOGICA CON B 
LO RISCRIVE 
FATTO 



Considerando le nozioni di base della modalità Grafica II si può intuire 
che è semplice, manipolando gli elementi nella tabella dei nomi, impostare 
molte diverse schermate di mappa della memoria. In pratica però la map- 
pa di memoria descritta appena in precedenza e nella figura 6.7 è facile 
da usare come le altre possibili, ma per molti altri versi è più conveniente. 
Si deve inoltre ricordare che, sebbene la tecnica che si è ora esaminata ci 
permetta di considerare la modalità di schermo Grafica II come una mo- 
dalità “bit mapped”, possiamo ancora svolgere le operazioni fondamentali 
sui caratteri, come se la memoria fosse ancora mappata a caratteri. Quindi 
l’intero schermo può essere spostato (verso l’alto o il basso) a passi da 8 
pixel ciascuno, manipolando semplicemente i 768 byte della VRAM. In al- 
ternativa possiamo definire l’ultimo blocco delle definizioni dei caratteri 
(quelli che corrispondono ai riferimenti della terza parte, la più bassa, del- 
la tabella dei nomi) come contenente un insieme di caratteri standard, e 
trattare i due terzi più alti dello schermo come se fossero “bit mapped”. 
Altre possibilità verranno senz’altro ideate dall’utente. 



Sprite: tecniche d’interruzione 

Ci sono due ovvi problemi connessi con la gestione degli sprite da parte 
del processore video TMS-9929A. Il primo è che ogni singolo sprite deve 
essere di un solo colore e il secondo è che tutti gli sprite devono essere, nel- 
lo stesso momento, della stessa grandezza. È però possibile produrre degli 
sprite che siano apparentemente di due colori, ed è anche possibile mante- 
nere sulla stessa schermata sprite di differente grandezza e fattore di in- 
grandimento. Ciò può essere ottenuto mediante il cambiamento delle ta- 
belle degli sprite in condizione d’interruzione. Si noti che, quando si acce- 
de al VDP durante un’interruzione, è essenziale che tale interruzione non 
avvenga mentre il VDP è accessibile dal programma principale. Ciò si ot- 
tiene ponendo tutti gli accessi al VDP del programma principale dopo un’i- 
struzione “HALT” dello Z-80 oppure segnalando con un flag che è in cor- 
so un accesso al VDP. 
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Sprite di due colori 



Variando nella tabella degli attributi degli sprite gli elementi in relazione 
con il nome ed il colore degli sprite ad ogni scansione video, è possibile 
produrre sprite che siano in apparenza di due colori. Si suggerisce di segui- 
re il metodo che segue: 

Prima di tutto definire in due modi gli sprite: una definizione per ciascun 
colore. Le definizioni devono risiedere nella VRAM una di seguito all’al- 
tra, in modo che le definizioni 0 e I definiscano un primo sprite multicolo- 
re, la definizione 2 e 3 un secondo e così via. 

In secondo luogo riservare una zona di memoria per una tabella di scam- 
bio. Ciascun elemento di quest’ultima fa riferimento ad un codice di colo- 
re per le definizioni di sprite di ordine dispari (nel suo semibyte di ordine 
maggiore); nel semibyte di ordine inferiore trova posto il codice del colore 
per le definizioni di ordine pari. Questa tabella va aggiornata ogni volta 
che viene definito un nuovo sprite. Infine è necessario scrivere una proce- 
dura guidata da interruzione per cambiare da una definizione all’altra (e 
quindi da un colore all’altro) ad ogni interruzione dovuta alla scansione 
video. La routine che segue illustra quanto detto: 



SPSWTB: 


DEFS 32 


SPSWIT: 


LD HL.SATTAB 




LD DE, SPSWTB 




LD B,32 


SPSWLP: 


CALL 004AH 
CP ODOH 
RET Z 
INC HL 




INC HL 




CALL 004AH 
XOR 1 
LD C,A 




CALL 004 DH 




INC HL 



;TABELLA DI SCAMBIO 
IDEI COLORI 

;IND. BASE PER TABELLA ATTR 

iSPRITE IN HL 

;IND. TABELLA SCAMBIO 

iCOLORI IN DE 

IMASS. NUM. ELEMENTI 

;DA SCAMBIARE 

; LEGGE POS. VERT. SPRITE 

;È IL SEGNALE FINE SPRITE? 

;SE È COSÌ FINE 

;SE NO INCREMENTA PUNT. 

TABELLA ATTR. SPRITE 

;DUE VOLTE PER PUNTARE 

;NOME SPRITE 

;LEGGI NUM. MODELLO 

iMODELLO DIVENTA +0 —1 

;SALVA IL NUOVO NUM. 

iMODELLO 

;E LO SCRIVE NEGLI ATTR. 
;DELLO SPRITE 

;PUNTA AL TAG DELLO SPRITE 
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LD A, (DE) 

AND A 
RR C 

JR C,SKP 
SLA A 

SLA A 
SLA A 
SLA A 

SKP: AND 15 

LD C,A 

CALL 004AH 
AND 80H 
OR C 

CALL 004 DH 
INC HL 
INC DE 

DJNZ SPSWLP 
RET 



PRENDE I COLORI 
DA SCAMBIARE 
PULISCE IL FLAG DI RIPORTO 
RUOTA BIT 0 DEL NUM. MOD. 
NEL BIT DI RIPORTO 
SE MODELLO È DISPARI NON.. 
SPOSTARE IL SEMI BYTE ALTO 
DEL COLORE 



; NEL SEMI BYTE BASSO 
; MASCHERA IL SEMI BYTE ALTO 
MEMORIZZA NUOVO COD. 
COLORE IN C 
;LEGGE VECCHIO TAG 
MASCHERA BIT "EARLY CLOCK" 
iSOMMA NUOVO COLORE 
ISCRIVE NUOVO TAG 
;NEGU ATTR. SPRITE 
;PUNTA PROSSIMO ELEMENTO 
JAB. ATTR. SPRITE 
;PUNTA PROSSIMO ELEM. 
TABELLA SCAMBIO COLORI 
;LO FA 32 VOLTE 



In questo modo due sprite di differente colore e definizione condividono 
la medesima entrata nella tabella degli attributi degli sprite, ciascuno dei 
quali viene visualizzato ad ogni seconda scansione del video televisivo. Può 
succedere che a causa di ciò insorga un leggero fenomeno di sfarfallio (“flic- 
ker”): ma in circostanze normali la persistenza di un tubo catodico è suffi- 
cientemente grande da rendere il suddetto fenomeno insignificante. 



Sprite di differente dimensione: scambio dei registri del VDP 



Per mantenere sulla stessa schermata sprite di differente grandezza o fatto- 
re d’ingrandimento è necessario disporre contemporaneamente nella VRAM 
di due tabelle degli attributi degli sprite - una per ciascuna grandezza o fat- 
tore d’ingrandimento. Poi si fa in modo che il VDP acceda a una e all’altra 
tra due successive scansioni video. 

Nelle modalità multicolore e Grafica I di solito è possibile progettare una 
disposizione della memoria VRAM in modo da ottenere quanto desidera- 
to senza sovrapporsi agli altri sottoblocchi del VDP. Nella modalità Grafi- 
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ca II, però, è necessario sovrapporre la seconda tabella degli attributi su 
una delle altre tabelle. La cosa più conveniente è “rubare”, a questo scopo, 
gli ultimi 16 byte delle definizioni degli sprite: la mappa di memoria che 
ne risulta viene illustrata nel seguito: 



0000H Tabella di generazione dei caratteri 

1800H Tabella dei nomi dei modelli 

1B00H Tabella degli attributi degli sprite (numero 1) 

2000H Tabella dei colori dei caratteri 

3800H Tabella di generazione dei modelli degli sprite 

3F80H Tabella degli attributi degli sprite (numero 2) 



Avendo in questo modo progettato una mappa della memoria adatta allo 
scopo, è cosa semplice scrivere una routine d’interruzione che scambi i bit 
di grandezza e fattore d’ingrandimento nel registro 1, e i bit dell’indirizzo 
di base della tabella degli attributi degli sprite che si trovano nel registro 
5. La procedura che segue illustra quanto detto, disponendo di due tabelle 

16 non ingranditi, l’altra per quelli 



degli attributi: una per gli sprite 16 * 
16 * 16 ingranditi: 

VA LI A EQU 0E2H 
VAL1B EQU 0E3H 
VALSA EQU 036H 



VAL5B EQU 07FH 

CTR: DEFB 0 

SPATSW: LD A, (CTR) 

INC A 
LD (CTR), A 
AND 1 

JR NZ,UNMAG 
LD B.VAL1B 
LD C,1 

CALL 0047H 
LD B.VAL5B 



;VALORE DEL REG. 1 PER 
iSPRITE 16*16 NON INGRANDITI 
.COME SOPRA PER SPRITE 
;INGRANDITI 
;VALORE REG. 5 
;PER IMPOSTARE INDIRIZZO 
;TAB. ATTR. A 1B00H 
; IMPOSTA TABELLA ATTR. 

;A 3F80H 

; IMPOSTA IL CONTATORE 
iPRENDE IL CONTATORE 
; DI SCAMBIO 
;LO INCREMENTA 
;LO ASSEGNA NUOVAMENTE 
;CONTROLLA BIT 0 
;SE VALE 1 ATTIVA SPRITE 
;NON INGRANO 
iVALORE PER REG. 1 
;(SPRITE INGRAND.) 

;NUM. REGISTRO 
ISCRIVE B NEL REGISTRO C 
iVALORE PER REG. 5, 
lATTRIBUTI SPRITE IN 1B00H 
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LD C,5 
CALL 0047 H 
RET 

UNMAG: LD B, VALI A 

LD C,1 

CALL 0047H 
LD B.VAL5A 
LD C,5 
CALL 0047H 
RET 

La tecnica appena illustrata non solo ci consente di avere contemporanea- 
mente sullo schermo sprite di due differenti grandezze, ma, poiché si han- 
no a disposizione due tabelle scambiabili di attributi degli sprite, si posso- 
no anche avere sullo schermo il doppio dei normali sprite, fino a un massi- 
mo di 64. Poiché di volta in volta è attiva una sola tabella degli attributi, 
possiamo avere fino a 8 sprite sulla stessa linea orizzontale, sempre con un 
massimo di quattro per ciascuna tabella. 

Si deve però ricordare che nei sistemi video dove la persistenza è partico- 
larmente breve, usando le tecniche illustrate si introdurrebbe un “flicker” 
inaccettabile - sfortunamente non completamente eliminabile. 

Accesso rapido al VDP: come evitare i problemi 
di temporizzazione 

Sebbene il metodo di accedere alla VRAM tramite il VDP abbia il vantag- 
gio di non occupare del prezioso spazio d’indirizzamento della CPU, ha 
lo svantaggio di essere lento. Questa situazione non è mai completamente 
evitabile, sebbene i suoi effetti più gravosi possano di solito essere elimina- 
ti. Per quanto concerne l’accesso alla VRAM c’è una regola fondamentale, 
che dovete sforzarvi di seguire quanto più possibile: 

USATE IL REGISTRO DTNDIRIZZAMENTO DEL VDP E ACCEDETE 
SEQUENZIALMENTE ALLA VRAM. 

Poiché l’accesso sequenziale alla VRAM richiede un solo trasferimento di 
dati, mentre quello non sequenziale ne richiede due, in quanto il registro 
d’indirizzamento va impostato ogni volta, il primo è considerevolmente 
più rapido. Per esempio, quando si scrive una routine per fare uno “scroll” 
dello schermo è più vantaggioso leggere l’intero schermo (la tabella dei no- 
mi) in un’area temporanea della RAM della CPU per poi riscriverlo per 
intero. 

Usando questa tecnica lo “scroll” può avvenire in un tempo di molto infe- 
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riore a 1/50 di secondo, mentre una routine analoga che facesse uso del- 
l’accesso non sequenziale richiederebbe un tempo di poco inferiore a 3/50 
di secondo. 

Se è necessario manipolare di volta in volta grosse regioni della VRAM, 
è conveniente leggere i dati nella RAM di sistema ed elaborarli in questa 
sede, prima di ricaricarli nella VRAM stessa in modo sequenziale. 
Facendo riferimento alla figura 6.2 si può vedere come l’accesso al VDP 
è molto più rapido durante i 4,300 microsecondi che seguono immediata- 
mente ogni interruzione dovuta al “flyback" della scansione video. Nei ca- 
si in cui la temporizzazione è estremamente critica è quindi vantaggioso 
effettuare tutti o la maggior parte degli accessi alla VRAM nella routine 
attivata dall’interruzione. 

Riassumendo, per ottenere un rapido accesso alla VRAM, si deve procede- 
re ad ottimizzare quanto segue: 

Prima di tutto limitare quanto possibile l’accesso alla VRAM. Tenete una 
copia dei dati di VRAM che è probabile dobbiate usare nella RAM indiriz- 
zarle dalla CPU. 

In secondo luogo dovete, quanto più possibile, accedere sequenzialmente 
alla VRAM: l’accesso non sequenziale è infatti dispendioso in termini di 
tempo e, se ben si pensa, il più delle volte superfluo. 

Infine se proprio il tempo è disperatamente stretto, tentate di accedere alla 
VRAM durante l’interruzione dovuta alla scansione video, poiché in que- 
sto periodo l’accesso alla VRAM non è mai rallentato, in quanto il VDP 
finisce tutte le attività precedentemente in corso. 
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Capitolo 7 

IL GENERATORE 
PROGRAMMABILE DI SUONI 



I registri per i dati 



II generatore di suoni scelto per il sistema MSX è il General Instruments 
AY-3-8910 (o equivalente). Questo integrato è già stato brevemente discus- 
so nel Capitolo 5. Il dispositivo contiene 16 registri a lettura/scrittura che 
consentono all’utente di produrre suoni e rumore “bianco” per uno qual- 
siasi dei tre canali separati. I registri per i dati dell’integrato per la genera- 
zione del suono sono: 



Registro 

Registro 

Registro 

Registro 

Registro 

Registro 

Registro 

Registro 

Registro 

Registro 

Registro 

Registro 

Registro 

Registro 

Registro 

Registro 



0: Regolazione accurata del periodo del suono per il canale A. 
1 : Regolazione di massima del periodo del suono per il canale A. 
2: Regolazione accurata del periodo del suono per il canale B. 
3: Regolazione di massima del periodo del suono per il canale B. 
4: Regolazione accurata del canale C. 

5: Regolazione di massima canale C. 

6: Periodo del segnale rumore. 

7: Abilitazione e direzione dell’ I/O. 

8: Ampiezza e forma d’onda per il canale A. 

9: Ampiezza e forma d’onda per il canale B. 

10: Ampiezza e forma d’onda per il canale C. 

11: Regolazione fine del periodo dell’onda. 

12: Regolazione del periodo dell’onda. 

13: Forma dell’inviluppo. 

14: Dato memorizzato per la porta A. 

15: Dato memorizzato per la porta B. 



I generatori di suono (registri 0..5) 

Ciascun canale ha associati due registri per il periodo del suono che devo- 
no generare. Questi determinano il periodo del suono che deve essere gene- 
rato in unità di 8 microsecondi. I registri per la regolazione accurata con- 
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tengono gli 8 bit meno significativi del periodo selezionato, mentre i regi- 
stri di regolazione di massima contengono i quattro bit di ordine superio- 
re. Per far sì che l’integrato emetta suono da un determinato canale deve 
essere posto a zero il bit appropriato del registro 7 (di abilitazione). 

Il generatore di rumore (registro 6) 

Si tratta del registro che controlla il singolo generatore di rumore pseudo- 
casuale di cui dispone l’integrato in questione. L’uscita da questo generato- 
re può essere mischiata a uno degli altri tre canali, quando ciò sia richiesto, 
ponendo a zero il bit appropriato del registro 7. Il periodo del generatore 
di rumore è determinato dai cinque bit meno significativi di questo registro. 

II registro di abilitazione (registro 7) 

Il registro 7 specifica se l’uscita dei tre canali debba comprendere il suono 
o il rumore, oppure entrambi. Determina inoltre se le due porte d’ingres- 
so/uscita sono usa'te in ingresso o in uscita. Il significato dei bit è il seguente: 

Bit 0: Se posto a 1 disabilita il suono in uscita dal canale A. 

Bit 1: Se posto a 1 disabilita il suono in uscita dal canale B. 

Bit 2: Se posto a 1 disabilita il suono in uscita dal canale C. 

Bit 3: Disabilitazione del rumore dal canale A. 

Bit 4: Disabilitazione del rumore dal canale B. 

Bit 5: Disabilitazione del rumore dal canale C. 

Bit 6: Se posto a 1 determina l’uso della porta A con modalità di uscita. 
Bit 7: Se posto a 0 determina l’uso della porta B con modalità di ingresso. 



Si noti che nel sistema MSX le porte d’ingresso/uscita sono usate per leg- 



gere l’ingresso dal 
d’ingresso. 



joystick, e quindi vanno sempre impostate con modalità 



Controllo d’ampiezza (registri 8.. IO) 

Ciascun canale ha il suo proprio registro di controllo dell’ampiezza. Il bit 
4 di questo registro specifica se va usata una definizione via hardware per 
il canale in questione. Ponendo a 1 questo bit, infatti, si pone l’ampiezza 
sonora sotto il controllo del generatore hardware d’inviluppo. Viceversa se 



il bit è posto a 0, 



da 0 a 3, dove il valore 0 indica il minimo di volume mentre 15 il massimo. 



Generatore d’inv 

L’integrato per la 
hardware che può 
viene indicato nel 



l’ampiezza viene determinata via software usando i bit 



iluppo (registri 11—13) 

generazione di suoni ha un solo generatore d’inviluppo 
èssere usato da uno o da tutti e tre i canali, secondo quanto 
registro di controllo d’ampiezza. 



180 




VALORE 


FORMA 


8 


\N\N 


9 


N 


10 


\AM 


11 


NI 


12 


AAAAAA 


13 


/ 


14 


A/V\ 


15 


/I 



Fig. 7.1 - Forme d'inviluppo. 



I bit da 0 a 3 del registro di controllo 13 determinano la forma dell’invilup- 
po in un modo piuttosto insolito. Nella figura 7.1 vengono dati i valori ne- 
cessari per generare via hardware le otto forme d’inviluppo disponibili. Ogni 
altro valore implica la duplicazione delle forma 9 o 15. 

La lunghezza di ogni rampa, sia verso l’alto sia verso il basso, viene impo- 
stata tramite il periodo dell’onda. 

II periodo dell’onda è un valore su 16 bit, che viene memorizzato dai regi- 
stri 11 (LSB) e 12 (MSB). Il periodo viene indicato in unità di 128 microse- 
condi ed indica il tempo da un passo all’altro della rampa. Se una rampa 
ha 16 passi (variando il volume da 0 a 15) il tempo totale della rampa stes- 
sa è di 1024 microsecondi per il periodo dell’onda. Quindi il periodo del- 
l’inviluppo dell’ondajndica, approssimativamente, la lunghezza della ram- 
pa in millisecondi. 



Le porte di ingresso/uscita (registri 14 e 15) 

Poiché i registri d’ingresso/uscita sonò usati dal sistema MSX per leggere 
dalle porte del joystick, è meglio non tentare di utilizzarli altrimenti: inol- 
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ire la tecnica con cui sono stati bufferizzati è piuttosto strana, ma risulta 
utile nella fase di configurazione del MSX. 

Note e periodi del suono 

Il periodo del suono richiesto può essere calcolato a partire dalla frequen- 
za richiesta con la seguente formula: 

Periodo = 125000 / Frequenza 

Inoltre la frequenza di ogni nota nella scala temperata nell’intero interval- 
lo di otto ottave viene calcolata, secondo lo Standard Internazionale della 
nota la. come segue: 

Frequenza = 440 * (2 A (Ottava + (N — 10)/12)) 

Dove: 

Ottava è il numero di ottava. 0 è l’ottava che contiene il DO centrale, — 1 
è l’ottava inferiore seguente, 1 quella superiore e così via. 

N è il numero della nota: 1 è il DO, 2 è il DO#, 3 è il RE ecc. 

Poiché il periodo è un valore intero, si deduce che i valori calcolati dalle 
. formule sopra riportate non producono esattamente la frequenza deside- 
rata. Gli errori sono però molto piccoli e di solito non si notano. 

La tabella che segue riporta i valori per l’Ottava 0 dedotti dalle formule 
e li mette in relazione con un fattore di errore, calcolato come percentuale 
della frequenza richiesta: 



Nota 


Frequenza 


DO 


261.626 


DO# 


277.183 


RE 


293.665 


RE# 


311.127 


MI 


329.628 


FA 


349.228 


FA# 


369.994 


SOL 


391.995 


SOL# 


415.305 


LA 


440.000 


LA# 


466.164 


SI 


493.883 



Periodo 


Errore 


478 


0.046% 


451 


0.007% 


426 


0.081% 


402 


0.058% 


379 


0.057% 


358 


0.019% 


338 


0.046% 


319 


0.037% 


301 


0.005% 


284 


0.032% 


268 


0.055% 


253 


0.038% 
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Date le formule riportate in precedenza, la procedura BASIC che segue cal- 
cola il periodo del suono per le note dell’intero intervallo di otto ottave in 
base ad una stringa d’ingresso nel formato ’ON’fOttava, Nota). Però, per 
semplificare l’analisi lessicale della stringa in ingresso, i valori dell’ottava 
variano tra 0 e 7 invece che tra —3 e 4. 

La parte più a destra della stringa indica la nota (da notare la denomina- 
zione inglese delle note: A = la, B = si, C = do, D = re, E = mi, F= fa, G = sol): 
usa due caratteri quando la nota è seguita dal segno # (diesis): 

10 INPUT A$ 

20 GOSUB 1000 
30 PRINTA 
40 GOTO 10 

1000 O = VAL(LEFT$(A$,1)) 

1010 A$ = MID$(AS,2) 

1020 FOR NC = 1 TO 12 

1030 READ B$:IF B$ = A$.THEN NO = NC 

1040 NEXTC 

1050 RESTORE 

1060 P = 125000 / (440*(2 A ((0 — 3) + (NO — 1 0)/1 2)) 

1070 A = INT(P) 

1080 RETURN 

1090 DATA C,C#,D,D#,E,F,F#,G,G# ,A,A#,B 

Se la procedura appena vista viene espansa, diventa semplice ottenere un 
programma che fornisca i periodi dei suoni in modo che possano essere 
usati in routine “musicali” scritte in codice macchina. 



Accesso al PSG in ambiente MSX 

Poiché i progettatori del MSX si riservano il diritto di apportare modifiche 
all’hardware del sistema stesso, garantendo la compatibilità del software, 
è possibile programmare il PSG solo attraverso le chiamate al sistema ope- 
rativo che vengono messe a disposizione nella ROM di sistema. Segue una 
descrizione di queste routine: 

*• 

INDIRIZZO FUNZIONE 

0090H Questa routine inizializza il PSG; non richiede parame- 

tri e può modificare tutti i registri. 

0093H Questa routine scrive il contenuto del registro E nel re- 

gistro del PSG specificato per mezzo dell’accumulato^ 
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0096H 



re; non ritorna alcun valore e lascia inalterati tutti i re- 
gistri. 

Questa routine legge un dato dal registro specificato dal- 
l’accumulatore, ritornando nell’accumulatore stesso il da- 
to letto e non modificando gli altri registri. 



Programmazione del PSG 

La programmazine del PSG consiste in una serie di scritture nei suoi regi- 
stri per specificare il periodo del suono per un dato canale, il periodo del 
rumore, se richiesto, una qualsiasi forma d’inviluppo che l'utente intenda 
utilizzare, il periodo dell’onda e (se non devono essere usate forme d’invi- 
luppo particolari) l’ampiezza per il canale prescelto. Queste azioni andreb- 
bero effettuate con il canale prescelto in condizione di disabilitazione (che 
si ottiene ponendo a 1 il bit ENABLE del registro 7). Consideriamo, come 
esempio di quanto si è detto, la seguente routine, che provoca la generazio- 
ne di un suono DO centrale da parte del canale A, con la forma d’invilup- 
po d’ampiezza 8: 



M1DC: 


LD A, 7 
CALL 0096H 


;LEGGE REGISTRO 
;ABILITAZIONE 




OR 9 


;D!SABIL1TA SUONO E RUMORE 
;PER CANALE A 




LD E, A 
LD A, 7 
CALL 0093H 


RISCRIVE IL REGISTRO 




LD E,1 
LD A,1 

CALL 0093 H 


; IMPOSTA LA REGOLAZIONE 
;DEL SUONO CANALE A 




LD E.ODEH 
LD A,0 
CALL 0093H 


IMPOSTA LA REGOLAZIONE 
; ACCURATA PER DO CENTRALE 




LD E, 8 
LD A, 13 
CALL 0093H 


-IMPOSTA FORMA ONDA 




LD E,15 
LD A, 11 
CALL 0093 H 


;PERIODO DEL SUONO 
;(REG. ACCURATA) 
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LD E.0 
LD A, 12 
CALL 0093H 


;PERIODO DEL SUONO 
;(REG. DI MASSIMA) 


LD E, 16 
LD A, 8 
CALL 0093 H 


ABILITA CONTROLLO ONDA 
;DEL CANALE A 


LD A, 7 
CALL 0096H 


;LEGGE REGISTRO 
ABILITAZIONE 


AND OFEH 


;PONE A 0 FLAG 
;DISABILITAZIONE CANALE A 


LD E, A 
LD A,7 
CALL 0093H 


;SCRIVE NUOVI VALORI 
ABILITAZIONE 


RET 





Sebbene questa routine sia abbastanza banale, illustra efficacemente le tecni- 
che di programmazione del PSG. Nel caso di un integrato come FAY-3-8910, 
dotato di enormi potenzialità, l’unico modo per sfruttarlo appieno consi- 
ste nella sperimentazione. In questa prospettiva si è dedicato il resto del 
capitolo alla presentazione di una serie di esempi che hanno lo scopo di 
familiarizzare ulteriormente il lettore con questa componente del sistema 
MSX. 



Musica su tre canali: il computer artista 

Il programma che viene presentato è guidato da interruzione in modo da 
consentire la generazione di suono da parte dei tre canali musicali, indi- 
pendentemente dalla contemporanea esecuzione di un altro programma. 
I dati per i tre canali musicali devono essere memorizzati agli indirizzi in- 
dicati come C1DAT, C2DAT e C3DAT come una serie di elementi di tre 
byte. Il primo byte di ciascun elemento è il valore di regolazione accurata 
per il periodo della^nota, il byte due è per la sua regolazione di massima 
mentre il byte tre indica la durata della nota in unità di 20 millisecondi. 
La fine del brano viene indicata scrivendo 255 nel byte di regolazione di 
massima dell’ultimo elemento di dati per il canale A. Mentre il program- 
ma è in esecuzione, e quindi viene eseguito il brano musicale, il volume di 
ciascun canale può essere modificato scrivendo agli indirizzi indicati dai 
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simboli VOLI, VOL2 e VOL3. Se desiderate fare delle prove con il genera- 
tore hardware di forma d’inviluppo potete attivarlo con il comando BA- 
SIC SOUND e quindi scrivere il valore 16 all’indirizzo del volume del ca- 
nale voluto. 



START: 



C1PTR: 



1NTHOK EQU 0F9DFH ;INDIRIZZO "AGGANCIO" 
;D'INTERRUZIONE 

PSGINI EQU 00090H ;ROUTINE 1NIZIALIZZAZIONE 
;PSG 

WRTPSG EQU 00093H ;PER SCRIVERE DATI NEL PSG 
RDPSG EQU 00096H ;PER LEGGERE DATI DAL PSG 
C1DAT EQU 0B000H ;l NIZIO DATI CANALI 1 
C2DAT EQU 0B400H ;INIZIO DATI CANALE 2 
C3DAT EQU 0B800H ;INIZIO DATI CANALE 3: TUTTI 
.POSSONO ESSERE MODIFICATI 
;SE RICHIESTO 



ORG 9000H 
LD HL.C1DAT 
LD (CIPTR).HL 
LD HL.C2DAT 
LD (C2PTR),HL 
LD HL.C3DAT 
LD (C3PTR),HL 
LD A,1 

LD (C1CTR),A 
LD (C2CTR),A 
LD (C3CTR),A 

CALL PSGINI 
LD A.LOW MUSROT 

LD (INTHOK + 1),A 

LD A, HIGH MUSROT 
LD (INTHOK + 2).A 
LD A.0C3H 

LD (INTHOK),A 

RET 



; IMPOSTA PUNTATORI Al DATI 



IMPOSTA I CONTATORI 
DI DURATA DELLE NOTE 
INIZIALIZZA IL PSG 
PRENDE INDIRIZZO BASSO 
DELLA ROUTINE MUSICALE 
LO SCRIVE NELL'AGGANCIO" 
D’INTERRUZIONE 

SCRIVE IND. ALTO COME SOPRA 
PRENDE ISTRUZIONE ’JP' 
DELLO Z-80 

CARICA NELL'AGGANCIO" 
D’INTERRUZIONE 
ORA L’INTERRUZIONE ABILITA 
LA ROUTINE MUSICALE 



DEFW 0 
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C2PTR: 

C3PTR: 

C1CTR: 

C2CTR: 

C3CTR: 

VOLI: 

VOL2: 

VOL3: 

MUSROT: 



DEFW 0 
DEFW 0 
DEFB 0 
DEFB 0 
DEFB 0 
DEFB 15 
DEFB 15 
DEFB 15 

PUSH AF 
LD A,(C1CTR) 
DEC A 

LD (CICTR).A 
OR A 

JR NZ.CHANB 
LD A, 7 

CALL RDPSG 
OR 1 
LD E, A 
LD A, 7 

CALL WRTPSG 
LD IX, (C1PTR) 
LD E,(IX + 0) 

LD A,0 

CALL WRTPSG 

LD A,(IX + 1) 

CP 255 

JR Z, START 
LD E, A 
LD A,1 

CALL WRTPSG 
LD A,(IX + 2) 

LD (ClCTR),A 



IMPOSTA TABELLA 
DELLE VARIABILI 
SALVA STATO VDP 
INIZIO ROUTINE MUSICALE 
DECREMENTA DURATA 
DELLA NOTA 

LA DURATA È 0: CIOÈ LA NOTA 
È FINITA 

SE DIVERSA DA 0 VA 
SUL CANALE 2 
SE NOTA È FINITA 



ALLORA SPEGNE CANALE 1 
PORTA PUNTATORE DATI IN IX 
PRENDE VALORE 
REGOLAZIONE ACCURATA 

LO SCRIVE NEL REGISTRO 0 
DEL PSG 
PRENDE VALORE 
REGOLAZIONE DI MASSIMA 
SE UGUALE AL DELIMITATORE 
DEL BRANO 
RINIZIALIZZA 



ALTRIMENTI LO SCRIVE 
NEL REG. 1 

IMPOSTA CONTATORE DURATA 
DELLA NOTA 
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CHANB: 



LD A, (VOLI) 

LD E, A 
LD A, 8 

CALL WRTPSG 

LD A, 7 
CALL RDPSG 
AND OFEH 
LD E, A 
LD A, 7 

CALL WRTPSG 

INC IX 
INC IX 
INC IX 

LD (CIPTR).IX 
LD A,(C2CTR) 
DEC A 

LD (C2CTR),A 
OR A 

JR NZ.CHANC 
LD A, 7 

CALL RDPSG 
OR 2 
LD E, A 
LD A, 7 

CALL WRTPSG 
LD IX, (C2PTR) 
LD E,(IX + 0) 



;PRENDE VOLUME PER CANALE A 



ISCRIVE VOLUME 
iCANALE 1 



;RI ABILITA PROD. SUONO 
;DAL CANALE 1 



PUNTA PROSSIMA NOTA 
SALVA PUNTATORE 
CANALE B 

DECREMENTA DURATA 
DELLA NOTA 

LA DURATA È 0: CIOÈ LA NOTA 
È FINITA 

SE DIVERSA DA 0 VA 
SUL CANALE 3 
SE NOTA È FINITA 



ALLORA SPEGNE CANALE 2 
PORTA PUNTATORE DATI IN IX 
PRENDE VALORE 
REGOLAZIONE ACCURATA 



LD A, 2 

CALL WRTPSG 
LD E,(IX+ 1) 

LD A, 3 

CALL WRTPSG 
LD A,(VOL2) 

LD E, A 



LO SCRIVE NEL REGISTRO 0 
DEL PSG 
PRENDE VALORE 
REGOLAZIONE DI MASSIMA 
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CHANC: 



LD A, 9 

CALL WRTPSG 
LD A, 7 

CALL RDP5G 
AND OFDH 
LD E.A 
LD A, 7 

CALL WRT PSG 
LD A.(IX + 2) 

LD (C2CTR),A 
INC IX 
INC IX 
INC IX 

LD (C2PTR),IX 
LD A,(C3CTR) 
DEC A 

LD (C3CTR),A 
OR A 

JR NZ.ENDMUS 
LD A, 7 

CALL RDPSG 
OR 4 
LD E, A 
LD A, 7 

CALL WRTPSG 
LD IX, (C3PTR) 
LD E,(IX + 0) 

LD A, 4 

CALL WRTPSG 
LD E,(IX + 1) 

LD A,5 

CALL WRTPSG 
LD A,(IX + 2) 



lALTRIMENTI LO SCRIVE 
;NEL REG. 1 



; IMPOSTA CONTATORE DURATA 
;DELLA NOTA 



;CANALE C 

;DECREMENTA DURATA 
;DELLA NOTA 

;LA DURATA È 0: CIOÈ LA NOTA 
;È FINITA 

;SE NOTA È FINITA 



ALLORA SPEGNI CANALE 3 
PORTA PUNTATORE DATI IN IX 
PRENDE VALORE 
REGOLAZIONE ACCURATA 

LO SCRIVE NEL REGISTRO 0 
DEL PSG 
PRENDE VALORE 
REGOLAZIONE DI MASSIMA 



; IMPOSTA CONTATORE DURATA 
;DELLA NOTA 



LD (C3CTR),A 
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LD A,(V0L3) 

LD E, A 
LD A, 10 
CALL WRTPSG 

LD A, 7 

CALL RDPSG 
AND OFBH 
LD E, A 
LD A, 7 

CALL WRTPSG 
INC IX 
INC IX 
INC IX 

LD (C3PTR),IX 
ENDMUS: POP AF 

RET 



-.ALTRIMENTI LO SCRIVE 
;NEL REG. 1 



;RIPRISTINA STATO VDP 



Effetti sonori con I’AY-3-8910 

La produzione di effetti sonori è un campo applicativo dove i risultati si 
possono ottenere soltanto con la sperimentazione. Infatti se è vero che il 
PSG è in grado di produrre praticamente qualsiasi suono voi desideriate, 
è altrettanto vero che potreste impiegare ore provando a impostare con di- 
versi valori i suoi registri prima di trovare una soluzione soddisfacente. Per 
far ciò il modo probabilmente migliore è il comando BASIC SOUND con 
il quale potete velocemente e con semplicità cambiare il contenuto di uno 
qualsiasi dei registri del PSG. Una volta trovati i valori desiderati per i suoi 
registri, si può poi codificare la necessaria routine in codice macchina per 
caricarli nei registri stessi in modo veloce ed efficiente. 

Per esempio il seguente programma BASIC produce il suono di uno sparo: 

10 SOUND 6,15:SOUND 7,7 

20 SOUND 8,16:SOUND 9,16:SOUND 10,16 

30 SOUND 1 1 ,0:SOUND 12,16:SOUND 13,0 

11 codice macchina Z-80 equivalente è il seguente: 

GUN: LD B,6 

LD HL.GUNTBL 
GUNLP: LD E,(HL) 
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LD A,B 
CALL 0093 H 
INC HL 
INC B 
LD A,B 
CP 14 

LR NZ.GUNLP 
RET 

GUNTBL: DEFB 15,7,16,16,16,0,16,0 



Generazione di suoni via software: la porta di un bit 

Oltre alla generazioni di suoni per mezzo dell’hardware del PSG, il sistema 
MSX riserva un bit della porta C del PP1 8255 per la generazione di suoni 
via software. Una chiamata al sistema operativo all’indirizzo 0135H accet- 
ta un valore in ingresso nell’accumulatore: se il valore è 0 il bit sonoro della 
porta in questione viene posto a 0, e viceversa se il valore è 1. Cambiando 
rapidamente il valore di questo bit si può ottenere la generazione di suono 
via software; provate le seguente routine: 

SFTSND: LD A,0 

CALL 135H 
LD A,1 
CALL 135H 
JR SFTSND 

Facendola eseguire potrete udire un suono acuto. Potete provare a sentire 
cosa accade nel cambiare il valore del suddetto bit con diverse frequenze. 
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Capitolo 8 

INGRESSO/USCITA: 

LA FINESTRA 

DEL COMPUTER SUL MONDO 



Il sistema MSX fornisce un insieme piuttosto vasto di procedure per effet- 
tuare funzioni come la lettura e scansione della tastiera, la lettura dell’in- 
gresso da joystick e delle tavolette per i giochi e la visualizzazione su scher- 
mo. In questo capitolo si prende dapprima in considerazione l’ingresso da 
joytick e poi l’ingresso/uscita in generale dalla console. 



I/O per i giochi: joystick e tavolette tattili 

Il sistema MSX prevede un massimo di due joystick, e considera come un 
terzo joystick le frecce direzionali per il cursore e la barra spaziatrice. Le 
seguenti procedure vengono usate per leggere lo stato del joystick e per ri- 
velare la pressione del suo pulsante. 

0D5H Legge lo stato corrente del joystick specificato ponendo il valo- 
re letto nell’accumulatore (il numero di joystick varia da 0 a 2, 
dove 0 indica le frecce del cursore). Il valore ritornato varia tra 
0 e 8. Si veda il diagramma che segue. 11 valore 0 significa che 
il joystick è centrato. Questa procedura può modificare tutti i 
registri 

1 

8 I 2 

7 — 0 — 3 

6 I 4 

5 
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0D8H Questa procedura rivela la pressione del pulsante del joystick spe- 
cificato nell’accumulatore. Il valore ritornato è 0 se il pulsante 
non è premuto, 255 viceversa. Viene modificata solo la coppia 
di registri AF. (Quando si usa il valore 0 per identificare il joy- 
stick, la routine in questione rivela la pressione della barra spa- 
ziatrice). 

Le porte per i joystick sono adatte anche ai paddle per i giochi. È possibile, 
nel sistema MSX, connetterne fino a 6 per ogni porta per joystick, per un 
totale di 12. Essi vengono numerato da I a 12. I paddle con numero dispari 
vengono connessi alla porta joystick 1, quelli pari alla porta 2. 

ODEH Questa procedura legge il paddle il cui numero è specificato nel- 
l’accumulatore, ritornando, nell’accumulatore stesso, un valore 
tra 0 e 255 dipendente dalla posizione del paddle specificato. Può 
modificare tutti i registri. 

Come ultima cosa di questa sezione, diciamo che alle porte joystick posso- 
no essere connesse tavolette tattili del tipo NEC PC-6051. La routine che 
segue viene usata per leggere lo stato della tavoletta tattile: 

ODBH Questa procedura accetta un identificatore di tavoletta nell’ac- 
cumulatore, e ritorna un valore Ietto dalla tavoletta tattile stes- 
sa, modificando tutti i registri. Gli identificatori e i valori ritor- 
nati sono i seguenti: 

ID Valore ritornato 

0 255 se la tavoletta nella porta 1 è premuta, 0 viceversa. 

1 Ritorna la coordinata X del punto di pressione sulla ta- 
voletta connessa alla porta 1. 

2 Come sopra, la coordinata Y. 

3 Ritorna 255 se il selettore sulla tavoletta 1 è premuto, 
0 altrimenti. 

4-7 Come sopra per la tavoletta tattile connessa alla porta 2. 



Ingresso/uscita da console 

Il sistema operativo fornisce le seguenti procedure per accedere alla tastie- 
ra e al video: 

09CH Controlla lo stato del buffer della tastiera. Ritorna con il flag 
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zero posto a 1 se il buffer è vuoto, e modifica la coppia di regi- 
stri AF. 

09FH Preleva un carattere dal buffer d’ingresso, o, se il buffer è vuo- 
to, attende che un carattere venga introdotto. Ritorna il codice 
ASCII del carattere stesso nell’accumulatore e modifica la cop- 
pia AF. 

0A2H Visualizza un carattere, il cui codice viene preventivamente im- 
postato nell’accumulatore, nella posizione corrente del cursore, 
lasciando inalterati tutti i registri. 

OCOH Produce un breve impulso sonoro (equivalente al CHR$(7)). Può 
modificare tutti i registri. 

0C3H Pulisce Io schermo, modificando le coppie di registri AF,BC e DE. 

0C6H Posiziona il cursore dello schermo sulla colonna H, riga L mo- 
dificando la coppia AF. 

OCCH Cancella la visualizzazione dei tasti funzionali, modificando tutti 
i registri. 

OCFH Visualizza i tasti funzionali, modificando tutti i registri. 



L’uso di queste procedure è sufficientemente evidente: la costruzione di ap- 
plicazioni utente non dovrebbe porre quindi particolari problemi, poiché 
esse rendono disponibili tutte le funzioni necessarie per la gestione dello 
schermo e della tastiera di console; ad esempio, una semplice routine di 
ingresso/uscita potrebbe essere costruita così: 



LD HL,0 
CALL 0C6H 
CALL 0C3H 
INLP: CALL 09FH 

CALL 0A2H 
CP 13 

JR NZ.1NPL 



;CURSORE IN ALTO A SINISTRA 
; SCHERMO PULITO 
ACCETTA UN CARATTERE 
;LO STAMPA 

;SE NON È <CR> RIPETE 



Si può anche scrivere una routine per richiedere l’introduzione di una pa- 
rola chiave che consenta la prosecuzione dell’esecuzione di un programma: 



PSSWD: LD HL.PSWORD 

PWLP: CALL 09FH 

CP(HL) 



HL PUNTA ALLA STRINGA 
CONTENENTE LA PAROLA 
CHIAVE 

ACCETTA UN CARATTERE 
DA TASTIERA 

CORRISPONDE ALLA PAROLA 
CHIAVE? 
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JR Z, PWSKP 




LD A,(HL) 
CP 

JR Z,GO 


PWSKP: 


JP 0000H 
INC HL 




CALL 0A2H 




JR PWLP 


PSWORD: 

GO: 


DEFB 'QUALSIASI 
TERMINATA DA &' 
INSERIRE QUI IL 



;SE Si SALTA ALLA FINE 
;DEL CICLO 

;FINE PAROLA CHIAVE? 

;SE Sì SALTA AL RESTO 
;DEL PROGRAMMA 
;ALTRIMENTI RIPARTE 
;INCREMENTA PUNTATORE 
;ALLA PAROLA CHIAVE 
;STAMPA IL CARATTERE 
PRECEDENTE 
CONTROLLA IL PROSSIMO 
CARATTERE 

PAROLA CHIAVE DESIDERATE 
RESTO DEL PROGRAMMA 



Selezione della partizione 



Poiché il PPI 8255 non è posto necessariamente allo stesso indirizzo in due 
differenti elaboratori MSX, sono state messe a disposizione due procedure 
per facilitare la lettura e la scrittura della porta A dell’8255 stesso (cioè il 
registro per la selezione della partizione primaria): 



0138H Legge il valore corrente del registro di selezione della partizio- 
ne, ritornando il valore nell’accumulatore e lasciando inalterati 
tutti gli altri registri. 

013BH Scrive il valore dell’accumulatore nel registro di selezione della 
partizione primaria, lasciando inalterati gli altri registri. 

Se quindi volete selezionare le pagine 2 e 3 della partizione 2 lasciando in- 
variate le pagine 0 e 1, per esempio, dovete effettuare le seguenti operazioni: 



CALL 138H 
AND 15 
OR 10100000B 
CALL 13BH 



LEGGE LA SELEZIONE 
DELLA PARTIZIONE 
MASCHERA I BIT PER LE 
PAGINE 0 E 1 

MASCHERA PER SELEZIONARE 
PARTI Z. 2 PER PAGINE 2 E 3 
IMPOSTA IL REGISTRO 
CON IL NUOVO VALORE 
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Esistono altre due routine di sistema operativo che interagiscono con il PP1 
8255: la prima si trova alla locazione 0132H, accetta in ingresso il valore 
dell’accumulatore e se è 0 spegne la luce dei CAPS, altrimenti la accende. 
La seconda è usata per scandire la tastiera. 



Scansione della tastiera: controllo dei singoli tasti 

0141H La routine posta a questo indirizzo scandisce una riga della ma- 
trice della tastiera (si veda Figura 8.1) secondo il valore impo- 
stato nell’accumulatore (da 0 a 9) e ritorna, nell’accumulatore 
stesso, un valore tale che il bit corrispondente a ciascuna colon- 
na della matrice, nella riga selezionata, è posto a zero se il tasto 
corrispondente è premuto. Se nessun tasto è premuto, la routine 
ritorna 255. 



RIGHE 



COLONNE 



7 6 5 4 3 2 1 0 



7 


6 


5 


4 


3 


2 


ì 


0 


+ 


i 




A 


- 


= 


9 


8 


B 


A 


- 


/ 




< 


] 


* 


J 


I 


H 


G 


F 


E 


D 


c 


R 


Q 


P 


O 


N 


M 


L 


K 


Z 


Y 


X 


w 


V 


U 


T 


S 


F3 


F2 


FI 


CODE 


CAP 


CRAPH 


CTRL 


SH1FT 


RETURN 


SEIECT 


BS 


STOP 


TAB 


ESC 


FS 


F4 


- 


i 


t 


- 


DEL 


INS 


HOME 


SPACE 



















Fig. 8.1 - La matrice della tastiera 



197 





Per chiarire quanto detto, considerate la seguente procedura, che 
scandisce la tastiera sino a quando i tasti ’Z’e ’X’sono premuti 
contemporaneamente: 



ZXCHK: 



LD A, 5 

CALL 0141 H 
AND 10100000B 

JR NZ, ZXCHK 
RET 



SCANDISCE LA RIGA 5 
;DELLA MATRICE TASTIERA 

;CONTROLLA CHE I BIT 5 E 7 
;SIANO ENTRAMBI A ZERO 
;SE NON LO SONO RIPETE 
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APPENDICI 



A .... Tabella codici dei caratteri 
B .... Tabella dei colori 
C .... Tabelle della RAM Video 
D .... Istruzioni Z-80 
E .... TMS 9118 VDP 
F .... AY-3-8910 PSG 




Appendice A 

TABELLA CODICI 
CARATTERE 



Riprodotta per gentile concessione della Toshiba UK Limited. 



4 bit più significativi 
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f Numeri esadecimali 



200 



Numeri esadecimali 





Appendice B 

TABELLA DEI COLORI 



0 .... Trasparente 

1 .... Nero 

2 .... Verde medio 

3 .... Verde chiaro 

4 .... Blu scuro 

5 .... Blu chiaro 

6 .... Rosso scuro 

7 .... Ciano 

8 .... Rosso medio 

9 Rosso chiaro 

10 .... Giallo scuro 

11 .... Giallo chiaro 

12 .... Verde scuro 

13 .... Rosso Magenta 

14 .... Grigio 

15 .... Bianco 



201 




Appendice C 

TABELLE DELLA RAM VIDEO 





Testo 40 col. 


Testo 32 col. 


HRG 


Multicolore 


Tabella nomi 


0 


6144 


6144 


2048 


Tabella modelli 


2048 


0 


0 


0 


Tabella colori 


— 


8192 


8192 


— 


Tabella attributi 
sprite 


— 


6912 


6912 


6912 


Tabella modelli 
sprite 


— 


14336 


14336 


14336 
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Appendice D 

ISTRUZIONI Z-80 



I simboli riportati sotto ogni flag hanno i seguenti significati: 

R: il flag è aggiornato quale risultato dell’operazione. 

0: il flag è posto a 0 
1: il flag è posto a 1 

C: lo stato del flag di riporto è copiato nel flag H. 

La lista delle altre abbreviazioni è riportata alla fine di quest’Appendice. 





FLAG 










FLAG 










S 


Z 


H 


N 


p 


C 




S 


Z 


H N 


P 


C 


ADC HL,ss 


R 


R 


R 


0 


R 


R 


CPI 


R 


R 


R 


1 


R 


- 


ADC A,s 


R 


R 


R 


0 


R 


R 


CPIR 


R 


R 


R 


1 


R 


- 


ADD A,n 


R 


R 


R 


0 


R 


R 


CPL 


- 


- 


1 


1 


- 


- 


ADD A,r 


R 


R 


R 


0 


R 


R 


DAA 


R 


R 


R 


- 


R 


R 


ADD A,(HL) 


R 


R 


R 


0 


R 


R 


DEC m 


R 


R 


R 


1 


R 


- 


ADD A, (IX + d) 


R 


R 


R 


0 


R 


R 


DEC IX 


- 


- 


- 


- 


- 


- 


ADD A,(IY + d) 


R 


R 


R 


0 


R 


R 


DEC IY 


- 


- 


- 


- 


- 


- 


ADD HL,ss 


- 


- 


R 


0 


- 


R 


DEC ss 


- 


- 


- 


- 


- 


- 


ADD IX, pp 


- 


- 


R 


0 


- 


R 


DI 


- 


- 


- 


- 


- 


- 


ADD IY.rr 


- 


- 


R 


0 


- 


R 


DJNZ e 


- 


- 


- 


- 


- 


- 


AND s 


R 


R 


1 


0 


R 


0 


EI 


- 


- 


- 


- 


- 


- 


BIT b,(HL) 


- 


R 


1 


0 


- 


- 


EX(SP),HL 


- 


- 


- 


- 


- 


- 


BIT b(IX + d) 


- 


R 


1 


0 


- 


- 


EX(SP),IX 


- 


- 


- 


- 


- 


- 


BIT b,(IY + d) 


- 


R 


I 


0 


- 


- 


EX(SP),IY 


- 


- 


- 


- 


- 


- 


BIT b,r 


- 


R 


1 


0 


- 


- 


EX AF,AF’ 


R 


R 


R 


R 


R 


R 


CALL cc,nn 


- 


- 


- 


- 


- 


- 


EX DE,HL 


- 


- 


- 


- 


- 


- 


CALL nn 


- 


- 


- 


- 


- 


- 


EXX 


- 


- 


- 


- 


- 


- 


CCF 


- 


- 


C 0 


- 


R 


HALT 


- 


- 


- 


- 


- 


- 


CP s 


R R 


R 


1 


R 


R 


IM 0 


- 


- 


- 


- 


- 


- 


CPD 


R 


R 


R 


1 


R 


- 


IM 1 


- 


- 


- 


- 


- 


- 


CPDR 


R 


R 


R 


1 


R 


- 


IM 2 


- 


- 


- 


- 


- 


- 
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IN A,(N) LD(IY + d),n ------ 

IN R,(C) RRRO R- LD(IY + d),r ------ 

INC (HL) RRRO R - LD(nn),A 

INC IX ------ LD(nn),dd ------ 

INC(IX 4- d) RRRO R - LD(nn),HL ------ 

INC IY ------ LD(nn),lX ------ 

INC (IY + d) RRRO R- LD(nn),lY ------ 

INC r R R R 0 R - LD R,A ------ 

INC ss LD r,(HL) ------ 

IND - R - I - - LD r,(IX + d) ------ 

iNDR - 1 - 1 - - LD r,(IY + d) ------ 

INI - R - 1 - - LD r,n ------ 

IN1R - 1 - 1 - - LD r,r’ 

JP(HL) ------ LD SP.HL ------ 

JP(IX) ------ LD SP,IX ------ 

JP(IY) ------ LDSP.1Y ------ 

JP cc.nn LDD - - 0 0 R - 

jp nn ------ LDDR - - 0 0 R - 

JR C,e LDI . . 0 0 R - 

JR e ------ LDIR - - 0 0 R - 

JR NC,e NEG R R R 1 R R 

JR NZ,e ------ NOP ------- 

jr z,e OR s R R 0 0 R 0 

LD A,(BC) ------ OTDR - 1 - 1 - - 

LD A,(DE) ------ OTIR - 1 - 1 - - 

LD A,I R R 0 0 R - OUT (C),r 

LD A,(nn) - OUT (n),A ------ 

LD A,R R R 0 0 R - OUTD - R - 1 - - 

LD(BC),A ------ OUTI - R - 1 - - 

LD(DE),A ------ POP IX 

LD(HL),n POP IY 

LD dd,nn ------ POP qq ------ 

LD HL,(nn) ------ PUSH IX 

LD (HL),r ------ PUSH IY ------ 

LD I,A ------ PUSH qq ------ 

LD IX, nn RES b,m ------ 

LD IX, (nn) ------ RET ------ 

LD (IX + d),n ------ RET cc ------ 

LD (IX + d),r ------ RETI ------ 

LD IY.nn ------ RÉTN ...... 

LD IY,(nn) ------ RL m RROORR 
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RLA 


- 


- 


0 


0 


- 


R 


SET 


b,(HL) 




- 


- 


- 


- 


- 


- 


RLC (HL) 


R 


R 


0 


0 


R 


R 


SET 


b,(IY + 


d) 


- 


- 


- 


- 


- 


- 


RLC (IX + d) 


R 


R 


0 


0 


R 


R 


SET 


b,r 




- 


- 


- 


- 


- 


- 


RLC (IY + d) 


R 


R 


0 


0 


R 


R 


SLA 


m 




R 


R 


0 


0 


R 


R 


RLC r 


R 


R 


0 


0 


R 


R 


SRA 


m 




R 


R 


0 


0 


R 


R 


RLCA 


- 


- 


0 


0 


- 


R 


SRL 


m 




R 


R 


0 


0 


R 


R 


RLD 


R 


R 


0 


0 


R 


R 


SUB 


s 




R 


R 


R 


1 


R 


R 


RR m 


R 


R 


0 


0 


R 


R 


XOR 


. s 




R 


R 


R 


1 


R 


R 


RRA 


- 


- 


0 


0 


- 


R 


SET 


b,(IX + 


d) 


- 


- 


- 


- 


- 


- 


RRC m 


R 


R 


0 


0 


R 


R 




















RRCA 


- 


- 


0 


0 


- 


R 




















RRD 


R 


R 


0 


0 


R 


R 




















RST p 


- 


- 


- 


- 


- 


- 




















SBC A,s 


R 


R 


R 


I 


R 


R 




















SBC HL,ss 


R 


R 


R 


1 


R 


R 




















SCF 


- 


- 


0 


0 


- 


I 





















ABBREVIAZIONI: 

r Registro: A, B, C, D, E, H o L. 
n Valore nell’intervallo 0 .. 255 (senza segno), 
s r,n,(HL),(IX + d) o (IY + d). 
m A, B, C, E, H, L, (HL), (IX + d), (IY + d). 
dd BC, DE, HL, SP [LD HL,(dd) LD(nn),dd], 
nn Valore nell’intervallo 0 .. 65535. 
qq BC, DE, HL, AF (POP qq, PUSH qq). 

ss BC, DE, HL, SP (ADC HL,ss; ADD HL,ss; DEC ss; INC ss; 

SBC HL.ss). 

pp BC, DE, IX, SP (ADD IX, pp). 

rr BC, DE, IY, SP (ADD IY,rr). 

b Bit da 0 a 7 

e Uno spiazzamento intero compreso nell’intervallo — 126 .. 129. 
p Un indirizzo di pagina zero dato nell’istruzione RESTART. Deve 
essere compreso tra 0 e 56 e deve essere multiplo di otto, 
cc Codice di condizione: C, NC, Z, NZ, P, M, PE, PO. 
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APPENDICE E 



Estratto dal Manuale del TMS 9118/9128/9128 Data 

Riprodotto per gentile concessione della Texas Instruments Ltd. 



2. Architettura 

Il Processore Video (Video Display Processor = VDP) TMS9118 è pro- 
gettato per fornire una semplice interfaccia tra un microprocessore e un 
apparecchio televisivo o un monitor a colori. Viceversa i TMS9128/9129 
VDP sono progettati per essere una semplice interfaccia tra un micropro- 
cessore e un monitor RGB o un codificatore video che produca il segnale 
video per guidare il monitor stesso. La Figura 2. 1 è un diagramma a bloc- 
chi delle parti principali dell’architettura del VDP d’interfaccia tra CPU, 
VRAM e televisore a colori. 



2.1 Interfaccia con la CPU 

Il VDP s’interfaccia alla CPU usando un bus dati su 8 bit, bidirezionale, 
tre linee di controllo e un’interruzione. Usando queste interfacce la CPU 
è in grado di effettuare quattro tipi di operazioni: 

1) Scrivere in uno degli otto registri a sola scrittura del VDP. 

2) Leggere il registro di stato del VDP. 

3) Scrivere nella VRAM dati (byte) da visualizzare. 

4) Leggere dati (byte) dalla VRAM. 

Ciascuna di queste operazioni implica che vengano effettuati uno o più 
trasferimenti di dati sul bus d’interfaccia. L’interpretazione del dato tra- 
sferito è determinata dallo stato delle tre linee di controllo del VDP. 

Nota 

La CPU può comunicare con il VDP sia simultaneamente che in modo 
asincrono rispetto alle operazioni di refresh dello schermo compiute dal 
VDP. Il VDP effettua le gestione della memoria e consente alla CPU di 
accedere alla VRAM ad intervalli periodici, anche a metà di una scansione 
video. 
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2.1.1 II bus dati tra CPU e VDP 



La CPU trasferisce dati tra sé stessa e il VDP attraverso un bus dati bidi- 
rezionale su 8 bit. Come viene mostrato nelle tabelle 2-1 e 2-2 gli otto bit 
del bus vengono denotati da CDO (MSB) a CD7 (LSB). 

Nota 

In questo manuale l’interfaccia tra CPU e VDP viene descritta assumendo 
che vengano utilizzati integrati TI. Altri costruttori di CPU devono asse- 
gnare le linee dati DO al LSB e D7 al MSB. Il modo corretto viene mostra- 
to nella Figura 2-2. In caso di connessione scorretta non si ottiene alcuna 
visualizzazione sullo schermo. 



2.1.2 Segnale di controllo d’interfaccia con la CPU 

Gli ingressi CSW, CSR e MODE controllano il tipo e la direzione del tra- 
sferimento dati. La linea CSW seleziona un’operazione di scrittura dalla 
CPU al VDP. Quando è attiva (bassa) gli otto bit CO - C7 vengono sentiti 
dal VDP. La linea CSR seleziona un’operazione di scrittura da parte della 
CPU nel VDP. Quando è attiva (bassa), il VDP emette gli otto bit C0-C7 
verso la CPU. Le linee CSW e CSR non possono mai essere contempora- 
neamente attive. Se ciò accade i dati trasferiti non sono validi. 

La linea MODE determina la sorgente o la destinazione di un trasferimen- 
to dati in scrittura o in lettura. Di solito questo ingresso è legato ad una 
linea di indirizzo di basso ordine della CPU. 



2.1.3 Registri del VDP 

Il VDP è dotato di otto registri a sola scrittura e un registro di stato a sola 
lettura. I registri a sola scrittura controllano l’operazione effettuata dal 
VDP e determinano l’allocazione della VRAM. Il registro di stato memo- 
rizza la condizione d’interruzione pendente, la collisione di sprite e la con- 
dizione di quinto sprite su una medesima linea di schermo. Le sezioni 2.2 
e 2.3 contengono rispettivamente descrizioni più dettagliate dei registri a 
sola scrittura e del registro di stato. 

Un valore può essere caricato in uno qualsiasi degli otto registri a sola scrit- 
tura usando un doppio trasferimento dati (di 8 bit) dalla CPU. Nella ta- 
bella 2-3 viene descritto il formato richiesto per ciascuno di questi due byte: 
il primo è il dato vero e proprio, il secondo indica la sua destinazione. Il 
MSB del secondo byte deve essere a 1. 
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Fig. 2-3 - Assegnazione dei piedini nel TMS 9118/9128/9129. 



I successivi quattro bit sono a 0, mentre gli ultimi tre contengono il nume- 
ro di registro (da 0 a 7). La linea MODE è alta per il trasferimento di en- 
trambi i dati. 

Nota 

Se i due bit più significativi del secondo byte indicano che è in corso una 
scrittura di un registro, il primo byte non è interpretato come byte d’indi- 
rizzo della CPU. 



2.1.4 La CPU scrive nella VRAM 

La CPU trasferisce dati nella VRAM attraverso il VDP usando un regi- 
stro di 14 bit autoincrementante. L’impostazione del registro d’indirizzo 
richiede un trasferimento di due byte. Ciascuno di questi richiede un tem- 
po di due microsecondi, per un totale di quattro microsecondi (si veda la 
tabella 2-3). Un ulteriore trasferimento di un byte è necessario per scrivere 
effettivamente il dato nel byte della VRAM indirizzato. Il tempo necessa- 
rio dipende dallo stato della linea MODE. Quindi il registro d’indirizzo 
si autoincrementa. Successivi trasferimenti sequenziali richiedono solo il 
trasferimento di un byte, poiché l’indirizzo è già correttamente imposta- 
to. Durante la fase di preparazione dell’indirizzo, i due bit più significati- 
vi del secondo byte d’indirizzo devono essere 0 e 1, rispettivamente. La 
linea MODE è alta per entrambi i trasferimenti che concernono l’indiriz- 
zo, mentre è bassa per il trasferimento del dato. La CSW è usata in tutti 
i trasferimenti per scrivere i dati su 8 bit nel VDP (si veda la tabella 2-3). 
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Tab. 2-3 - Sequenze di trasjerimento dati e di "se/up" tra CPU e VDP 



OPERAZIONE 


0 


1 


2 


BIT 
3 4 


5 


6 


7 


csw 








Scrittura in registri VDP 
Byte 1 : Dato da scrivere 


O u 


D, 


d 2 


D, 


d 4 


D 5 


D,. 


D, 


0 


1 


1 


2 4S 


Byte 2: Selezione 
del registro 


1 


0 


0 


0 


0 


RS„ 


RS, 


RS 2 


0 


1 


1 


2 jzS 


Scrittura nella VRAM 
Byte 1 : Impostazione 
dell’indirizzo 


Aé 


A? 


Ah 


Ay 


A m 


Ai 1 


A 12 


Ai j 


0 


1 


1 


2 /*s 


Byte 2: Impostazione 
dell’indirizzo 


0 


1 


Ao 


A, 


a 2 


A j 


A 4 


A, 


0 


1 


1 


2 fis 


Byte 3: Dato da scrivere 


Do 


D, 


d 2 


D, 


Da 


D, 


D„ 


D, 


0 


] 


0 


_ 


Lettura registro di stato 
Byte 1 : Dato da leggere 


Do 


D, 


d 2 


D, 


Da 


D s 


Do 


D, 


1 


0 


1 


2 fis 


Lettura della VRAM 
Byte 1: Impostazione 
dell’ indirizzo 


Aè 


A 7 


Ag 


As> 


Aio 


Au 


A 1 2 


A 1 3 


0 


1 


1 


2 iì s 


Byte 2: Impostazione 
dell’indirizzo 


0 


0 


Ao 


A, 


A 2 


A j 


Aa 


Ao 


0 


1 


1 


_ 


Byte 3: Dato da leggere 


Do 


D, 


d 2 


D, 


Da 


D, 


Do 


D, 


1 


0 


0 


— 



2.1.5 La CPU legge il registro di stato del VDP 

Come viene illustrato nella tabella 2-3, la CPU può leggere il registro di 
stato del VDP con un unico trasferimento di dati. La linea MODE è alta. 
La linea CSR viene usata per segnalare al VDP che è richiesta un’opera- 
zione di lettura. Ciascuna lettura del registro di stato richiede un minimo 
di due microsecondi. 



2.1.6 La CPU legge dalla VRAM 

La CPU legge dalla VRAM attraverso il VDP usando il registro d’indiriz- 
zo ad autoincremento. Una volta che l’indirizzo è stato impostato, il tra- 
sferimento del byte di dato indirizzato nella VRAM è tutto ciò che è ne- 
cessario fare. Quindi il registro d’indirizzo si autoincrementa. Successivi 
trasferimenti sequenziali per leggere dati nella VRAM richiedono quindi 
il trasferimento di un solo byte poiché l’indirizzo è già predisposto. Du- 
rante la preparazione del registro d’indirizzo i due bit più significativi del 
secondo byte di indirizzo devono essere posti a 0. Impostando così il regi- 
stro d’indirizzo s’inizia un ciclo di lettura dalla VRAM, e il dato letto è 
disponibile per il primo trasferimento dati verso la CPU (si veda la tabella 



210 









2-3). La linea MODE è alta per il trasferimento dei byte d’indirizzo e bas- 
sa per il trasferimento del dato. 

La CPU interagisce con la memoria VRAM attraverso il VDP. Occorrono 
quattro microsecondi per la preparazione dell’indirizzo per una scrittura 
e due microsecondi per la preparazione dell’indirizzo per una lettura. Il 
tempo necessario alla CPU per trasferire un byte di dato da o verso la me- 
moria VRAM può variare da uno a otto microsecondi. Una volta che al 
VDP è stato “detto” di leggere o scrivere un dato dalla VRAM, ci voglio- 
no circa due microsecondi prima che il VDP sia pronto per il trasferimen- 
to effettivo del dato. Questo tempo è misurato a partire dalla salita inizia- 
le della linea CSW sul byte 3 per una scrittura e dalla salita iniziale della 
linea CSR sul byte 2 per una lettura. Oltre a questo ritardo di due microse- 
condi, il VDP deve attendere una “finestra d’accesso” per la CPU (cioè 
un periodo di tempo in cui il VDP stesso non è impegnato nel refresh della 
memoria o nella visualizzazione su video) perché il dato possa essere letto 
o scritto. 

Il caso peggiore tra la presentazione di due successive finestre di accesso 
si ha nella modalità Grafica I e II quando si stanno usando gli sprite (si 
veda la tabella 2-4). Durante la visualizzazione attiva, le finestre per la CPU 
si presentano ogni 16 cicli di memoria, portando ad un ritardo massimo 
di 6 microsecondi (un ciclo di memoria dura circa 372 nanosecondi). Nella 
modalità testo la finestra di accesso per la CPU si presenta almeno ogni 
tre cicli di memoria, con un ritardo pari a 1 .1 microsecondo nel caso peg- 
giore. Infine nella modalità multicolore la finestra per la CPU si presenta 
almeno una volta ogni quattro cicli di memoria. 

Se l’utente ha necessità di accedere alla memoria in due microsecondi, ci 



Tab. 2-4 - Tabella dei tempi di ritardo nell’accesso alla memoria 



Condizione 


Modalità 


Ritardo 

VDP 


Tempo d’attesa 
per finestra d’accesso 


Tempo 

totale 


Area attiva 
di visualizzazione 


testo 


2 fis 


0-1.1 ^s 


2-3.1 jis 


Area attiva 
di visualizzazione 


Grafica 
1, II 


2 ns 


0-5.95 M s 


2-8 ns 


4.300 fis 
dopo segnale 
d’interruzione 


-.tutte 


2 (x s 


0 ns 


2 /as 


Blank bit = 0 
Registro 1 


tutte 


2 fis 


0 ns 


2 (ls 


Area attiva 
di visualizzazione 


multicolore 


2 fis 


0-1.5 /is 


2-3.5 its 
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sono due situazioni in cui il tempo d’attesa per l’accesso è effettivamente 
nullo. Entrambe non dipendono dalla modalità corrente di visualizzazione. 
La prima si presenta quando il bit “blank” del registro 1 è 0. In questa 
situazione sullo schermo viene visualizzato solo il colore del bordo, e il 
VDP non deve attendere per una finestra d’accesso della CPU. 

La seconda si presenta durante l’intervallo di “ritorno” (“flyback”) ver- 
ticale della scansione del video. 11 VDP instaura in questo caso un’interru- 
zione al termine di ogni area attiva. Questo segnale indica che il VDP sta 
entrando nella fase di ritorno verticale, e che per i prossimi 4.3 millisecon- 
di non vi è tempo di attesa per una finestra d’accesso. Se l’utente vuole 
che la CPU acceda alla memoria in questo intervallo, la CPU di controllo 
deve accorgersi del segnale d’interruzione lanciato dal VDP (può control- 
larlo periodicamente, in “polling”, o considerarlo come un’interruzione 
in ingresso). 

Il programma che si accorge dell’interruzione deve tenere presente il suo 
proprio ritardo nel rispondere all’interruzione stessa e tener presente quanto 
tempo rimane dei 4.3 millisecondi del periodo di refresh di cui si diceva 
prima. La CPU deve scrivere 1 nel bit di abilitazione delle interruzioni del 
registro 1 in fase d’inizializzazione per consentire l’interruzione ad ogni 
scansione video. Deve poi leggere il registro di stato ad ogni interruzione. 



2.1.7 CPU guidate da interruzioni 

In un ambiente guidato da interruzioni (cioè nel quale la CPU accetta le 
interruzioni esterne) è possibile che una interruzione si verifichi prima che 
una delle sequenze mostrate nella tabella 2-3 finisca. Per esempio, può ca- 
pitare una interruzione immediatamente dopo il caricamento del byte 1 e 
2 d’indirizzo in una operazione di scrittura su VRAM. In questo caso la 
routine di gestione dell’interruzione non sa a quale punto della sequenza 
ci si trovava. Si rende quindi necessario disabilitare le interruzioni, per poi 
riabilitarle, durante ogni sequenza di preparazione. In tal modo si previe- 
ne una perdita di continuità tra la CPU e il VDP. 

Se questa continuità non è importante, si può leggere il registro di stato. 
La logica interna dell’interfaccia della CPU viene in questo modo rinizia- 
lizzata e accetta il prossimo byte come il primo evento di una nuova ses- 
sione d’interfaccia tra CPU e VDP. Se nessuna delle due tecniche citate 
è accettabile, è necessario usare l’interrogazione periodica (“polling”). 



2.1.8 Interruzione del VDP 

Il pin di output INT del VDP viene usato per generare un’interruzione al 
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termine di ogni scansione della zona attiva (approssimativamente ogni 1/60 
di secondo per TMS 9118/9128 e 1/50 di secondo per TMS 9129). 11 pin 
INT è attivo se è stato posto a 1 il bit di abilitazione delle interruzioni (El) 
del registro 1 del VDP e se il flag F del registro di stato è anch’esso posto 
a 1. Le interruzioni sono rimosse quando si effettua una lettura del regi- 
stro di stato. 

L’interruzione del VDP si presenta alla fine della visualizzazione del pia- 
no dei caratteri attivo, prima che vengano visualizzate le ultime linee di 
sfondo. Questa interruzione può essere usata per muovere gli sprite o ag- 
giornare la visualizzazione sul piano dei modelli, ma non è utile per cam- 
biare rapidamente il colore dello sfondo. 



2.1.9 RESET/SYNC 

Il VDP viene inizializzato esternamente quando viene tenuto attivo (bas- 
so) per un minimo di tre microsecondi l’ingresso RESET/SYNC. Il RE- 
SET esterno sincronizza tutti i temporizzatori, imposta i contatori vertica- 
li e orizzontali a valori noti, e pulisce i registri 0 e 1 del VDP. Lo schermo 
viene automaticamente pulito poiché il bit “blank” del registro 1 viene 
posto a 0. Comunque il VDP continua il refresh della memoria anche se 
lo schermo viene pulito. Per ripristinare la schermata è sufficiente scrivere 
gli opportuni valori nei registri 0 e I. Mentre la linea RESET/SYNC è at- 
tiva, il VDP non fa il refresh della memoria. 



2.2 Registri a sola scrittura 

Gli otto registri a sola scrittura del VDP sono mostrati nella Figura 2-4. 
11 loro valore viene impostato dalla CPU secondo le modalità descritte nella 
sezione 2.1.3. I registri 0 e 1 contengono dei fiag per abilitare o disabilita- 
re varie funzioni e modalità operazionali del VDP. I registri dal 2 al 6 de- 
finiscono gli indirizzi di partenza per numerosi sottoblocchi logici della 
VRAM. Questi sottoblocchi costituiscono le tabelle che vengono usate per 
produrre l’immagine desiderata sullo schermo. Il contenuto di queste ta- 
bella è determinato dal microprocessore. II registro 7 viene usato per defi- 
nire i colori del testo. e dello sfondo. 

1 registri vengono descritti singolarmente nelle sezioni che seguono: 



2.2.1 Registro 0 

Il registro 0 contiene due bit di controllo delle opzioni del VDP. Tutti gli 
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REGISTRO 



MSB 



LSB 



OONT 

CARE 


RCANK 


c 


-, 


Ma 


0 


SUE 


MAQ 




0 


0 


0 


o 


INDIRIZZO DI BASE TABELLA 
DEI NOMI DEI MODELLI 



1 1 1 1 1 » 

INDIRIZZO 01 BASE TABELLA COLORI OEI MODELLI 
1 1 I I I I 













INDIRIZZO DI BASE 


0 


0 


0 


0 


0 


TABELLA DI GENERAZIONE 
OEI MODELLI 



1 1 1 1 1 r 

5 0 INDIRIZZO DI BASE TABELLA ATTRIBUTI DEGLI SPRITE 

I I L_ 1 - l L 













INDIRIZZO DI BASE 


l ° l 


0 


0 


0 


0 


TABELLA DI GENERAZIONE 
DEGLI SPRITE 



1 » ' 1 1 
COLORE 1 (TESTO) 


• • J 

COLORE 0 (TESTO)iSFONDO 


1 L 1. 1 


1 . 1 I 



STATO 

ISOLA LETTURA) 



' » c 



I ' ‘ 

NUMERO QUINTO SPRITE 



Fig. 2-4 - Registri de I VDP. 

altri bit sono riservati per espansioni future e devono essere posti a zero. 
BIT 6 - M3 (bit 3 di modalità) (si veda sezione 2.2.2 per la descrizione). 
BIT 7 - Abilitazione/disabilitazione di un VDP esterno (si veda sezione 
3.7 per la descrizione). 0 disabilita il VDP esterno, 1 lo abilita. 

2.2.2 Registro 1 (contiene 6 bit di controllo di opzioni del VDP) 

BIT 0 - Non usato. 

BIT 1 - Abilitazione/disabilitazione BLANK. Se posto a 0 fa in modo che 
venga pulita l’area attiva di visualizzazione, lasciando sullo schermo solo 
il colore del bordo. Posto a 1 abilita la visualizzazione nell’area attiva. 
BIT 2 - EI (Enable Interrupt = Abilita le interruzioni): posto a zero disa- 
bilita le interruzioni del VDP, viceversa se posto a 1. 

BIT 3, 4 - MI e M2 (bit 1 e 2 di modalità): i bit MI, M2 e M3 determinano 
il modo operativo del VDP: 

MI M2 M3 

0 0 0 Modalità Grafica I 
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0 0 1 Modalità Grafica 11 

0 1 0 Modalità multicolore 

1 0 0 Modalità testo 

BIT 5 - Riservato. 

BIT 6 - Selettore delle dimensioni degli sprite: posto a 0 fa in modo che 
siano usati sprite di 8 * 8 pixel; posto a I sprite di 16 * 16. 

BIT 7 - MAG (ingrandimento degli sprite): posto a I raddoppia le dimen- 
sioni degli sprite e viceversa le riporta a quelle normali. 

2.2.3 Registro 2 

Il registro 2 definisce l’indirizzo di partenza per il sottoblocco della tabella 
dei nomi dei modelli. La tabella dei nomi dei modelli contiene il nome o 
il puntatore alla definizione del modello contenuta nella tabella di genera- 
zione dei modelli. Il valore contenuto nel registro 2 è compreso nell’inter- 
vallo da 0 a 15. Il contenuto del registro forma i quattro bit più significati- 
vi degli indirizzi su 14 bit della tabella dei nomi dei modelli: ne consegue 
che l’indirizzo di questa tabella è uguale a (Registro 2)* 400 (esadecimale). 
La tabella 2-5 mostra i possibili indirizzi di partenza del sotto-blocco della 
tabella dei nomi dei modelli. 



Indirizzo di partenza = registro 2 * 400 (esad.) 



R2 


Indirizzo 


00 


0000 


01 


0400 


02 


0800 


03 


0C00 - 


04 


1000 


05 


1400 


06 


1800 


07 


1C00 


08 


2000 


09 


2400 


0A 


2800 


0B 


2C00 


OC 


3000 


OD 


3400 


OE 


3800 


OF 


3 C00 - 



Massimo consentito 



Tab. 2-5 - Indirizzamento con il registro 2 
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2.2.4 Registro 3 

Il Registro 3 definisce l’indirizzo di partenza del sottoblocco della tabella 
dei colori dei modelli. Questa tabella definisce quale colore è associato agli 

I e agli 0 della definizione del modello del carattere. Il valore contenuto 
nel registro 3 è compreso nell’intervallo tra 0 e 255. Questo contenuto co- 
stituisce gli otto bit più significativi dell’indirizzo su 14 bit della tabella dei 
colori dei modelli: quindi il suo indirizzo può essere calcolato come Regi- 
stro 3 * 40 (esadecimale). La tabella 2-6 mostra i possibili indirizzi di par- 
tenza per la tabella dei colori dei modelli, con l’eccezione della modalità 
Grafica II. 

Nota 

II Registro 3 funziona in modo differente nella modalità Grafica II. In questa 
modalità la tabella dei colori dei modelli può essere allocata solamente a 
uno tra due indirizzi della VRAM: 0000 e 2000. Se il suo indirizzo è 0000 
allora il bit più significativo del registro 3 deve essere posto a 0. Se l’indi- 
rizzo è 2000, vale viceversa (lo stesso bit è cioè posto a 1). I bit da 1 a 7 
del registro 3 devono essere posti a 1: ne consegue che nella modalità Gra- 
fica II gli unici valori del registro 3 che funzionano correttamente sono 7F 
e FF. 



2.2.5 Registro 4 

Il registro 4 definisce l’indirizzo di partenza per il sottoblocco della tabella 
di generazione dei modelli. Questa tabella contiene una libreria di modelli 
(definizioni delle forme dei caratteri) che possono essere visualizzati sullo 
schermo. Il valore contenuto nel registro 4 è compreso tra 0 e 7. Tale valore 
costituisce i tre bit più significativi degli indirizzi su 14 bit della tabella di 
generazione dei modelli: quindi l’indirizzo di partenza di quest’ultima è pari 
a Registro 4 * 800 (esadecimale). La tabella 2-7 mostra i possibili indirizzi 
di partenza per il sottoblocco della tabella di generazione dei modelli, con 
l’eccezione della modalità Grafica IL 

Nota 

II registro 4 funziona diversamente quando il VDP è in modalità Grafica II. 
In questa modalità la tabella di generazione dei modelli può essere sola- 
mente posta a due locazioni della VRAM: 0000 e 2000. Se vale il primo 
caso il bit 5 del registro 4 deve essere 0; se vale il secondo caso (indirizzo 
2000) vale viceversa, cioè il bit 5 è posto a 1. In entrambi i casi i bit 6 e 
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7 devono essere a 1. Quindi nella modalità Grafica II i soli valori accettabi- 
li per il registro 4 sono >03 e >07. 

Attenzione 

Il bit 5 del registro 4 DEVE avere il valore opposto a quello del bit 0 del 
registro 3, in modo che le due aree di 8K siano separate. Altrimenti la mo- 
dalità Grafica II non funziona correttamente. 

Indirizzo di partenza = Registro 4 * 800 (esadec.) 



R4 


Indirizzo 
di partenza 


00 


0000 


01 


0800 - 


02 


1000 


03 


1800 


04 


2000 


05 


2800 


06 


3000 


07 


3800 - 



- Massimo per RAM di 4K 



- Massimo consentito 



Tab. 2-7 - Indirizzamento con il registro 4 



2.2.6 Registro 5 

Il Registro 5 definisce l’indirizzo di partenza del sotto-blocco della tabella 
degli attributi degli sprite. Questa tabella specifica dove i vari sprite deb- 
bano essere visualizzati sullo schermo. Il valore contenuto nel registro è com- 
preso tra 0 e 127. Esso forma i sette bit più significativi degli indirizzi su 
14 bit della tabella degli attributi degli sprite: quindi l’indirizzo di partenza 
è uguale a registro 5 * 80 (esadecimale). 



2.2.7 Registro 6 

Il registro 6 definisce l’indirizzo di partenza del sotto-blocco della tabella 
di generazione dei modelli degli sprite. Questa tabella contiene la descri- 
zione della forma degli sprite. Il valore contenuto nel registro è compreso 
tra 0 e 7. Esso forma i tre bit più significativi degli indirizzi su 14 bit della 
tabella di generazione dei modelli degli sprite: quindi l’indirizzo di parten- 
za è uguale a registro 6 * 800 (esadecimale). La tabella 2-9 mostra i possibi- 
li indirizzi di partenza per la suddetta tabella: 
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Tab. 2-9 - Indirizzamento con il registro 6 
Indirizzo di partenza = Registro 6 * 800 (esadec.) 



R4 


Indirizzo 
di partenza 


00 


0000 


01 


0800 - 


02 


1000 


03 


1800 


04 


2000 


05 


2800 


06 


3000 


07 


3800 - 



Massimo per RAM di 4K 



- Massimo consentito 



2.2.8 Registro 7 



I 4 bit di ordine più alto del registro 7 contengono il codice del colore 1 
nella modalità testo. Gli altri 4 contengono il codice per il colore 0 nella 
modalità testo, il colore del bordo e dello sfondo nelle altre modalità. 



2.3 REGISTRO DI STATO 

Il VDP ha un solo registro di stato di 8-bit, a sola lettura che può essere 
acceduto dalla CPU. Il registro di stato contiene il flag di interruzione (F), 
il flag di collisione di sprite (C), il flag di quinto sprite (5S), e il numero 
del quinto sprite (se esiste). Il formato del registro di stato è mostrato di 
seguito e viene discusso nei paragrafi che seguono. 



F 


5S 


C 


Numero quinto sprite 



In qualsiasi momento il registro di può essere letto per controllare i flag 
F,C e 5S. La lettura del registro implica che venga azzerato il flag di inter- 
ruzione F. 

Attenzione 

Letture asincrone causano l’azzeramento del flag F, che viene quindi perso. 
Quindi il registro di stato deve essere letto solo quando il VDP ha una in- 
terruzione pendente. 
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2.3.1 11 flag d’interruzione (F) 



11 flag F d’interruzione viene posto a 1 alla fine di ogni scansione dell’ulti- 
ma linea dell’area attiva del video. Viene reimpostato a 0 dopo che il regi- 
stro di stato è stato letto o quando il VDP viene reinizializzato esternamente. 
Se nel registro 1 del VDP è attivo (cioè è posto a 1) il bit abilitazione d’in- 
terruzione, la linea di uscita di interruzione del VDP (INT) viene tenuta 
attiva (bassa) fintantoché il flag F d’interruzione è posto a 1. 

NOTA 

È necessario leggere il registro di stato ad ogni scansione video per ripristi- 
nare Io stato delle interruzioni e poter ricevere le successive. 

2.3.2 II flag di collisione di sprite (C) 

Il flag C di collisione di sprite del registro di stato viene posto a 1 quando 
vi è sovrapposizione di due o più sprite. Questa situazione si presenta quando 
due sprite sullo schermo hanno almeno un pixel coincidente. Vengono con- 
siderati anche gli sprite definiti di colore trasparente, così come quelli che 
sono completamente o parzialmente fuori dallo schermo. Per rendere invi- 
sibile uno sprite è necessario definirlo con colore trasparente. Il flag C vie- 
ne rimesso a 0 quando il registro di stato viene letto o quando il VDP viene 
reinizializzato esternamente. Porre a 1 il flag C non causa un’interruzione. 
Gli sprite che si trovano oltre il termine (DO) della tabella degli attributi 
degli sprite non vengono considerati. Se, per esempio, un terminatore DO 
viene messo nel byte di posizione verticale dello sprite 3 nella tabella degli 
attributi degli sprite, quelli di numero da 4 a 31 non vengono visualizzati. 

Attenzione 

Subito dopo l’accensione del sistema, il registro di stato dovrebbe essere 
letto per assicurarsi che sia stato posto a 0 il flag di collisione. 

Il VDP controlla le eventuali collisioni in ogni possibile pixel durante la 
generazione del pixel stesso, indipendetemente dalla sua posizione sullo scher- 
mo. Questo accade ogni 1/60 di secondo per i TMS9118 e TMS9128, e 1/50 
di secondo per il TMS 9129. Quindi quando durante questi intervalli si muove 
uno sprite per più di una posizione, è possibile che si verifichi la sovrappo- 
sizione di più pixel o addirittura che uno sprite sia passato completamente 
sopra un altro prima che il VDP controlli eventuali collisioni. 

2.3.3 Numero e flag (5S) del quinto sprite 

Il flag di quinto sprite (5S) del registro di stato viene posto a 1 quando ci 
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sono cinque o più sprite sulla medesima linea orizzontale (linee da 1 a 192) 
e il flag di interruzione è posto a zero. Il flag di quinto sprite viene impo- 
stato a 1 anche se gli sprites sono posizionati fuori dello schermo. Il flag 
5S viene reimpostato a zero quando viene letto il registro di stato o il VDP 
viene rinizializzato dall’esterno. Il numero del quinto sprite è posto nei 5 
bit meno significativi del registro di stato, ovviamente quando è a 1 il flag 
di quinto byte. Porre a 1 il flag di quinto sprite non provoca un’interruzione. 



2.3.4 Oscillatore e temporizzatore 

Il VDP è stato progettato per funzionare con un temporizzatore da 10.738635 
( + /— 0.0005) MHz per generare i segnali interni di sincronismo richiesti. 
Un cristallo a frequenza-fondamentale e modo-parallelo è necessario per 
l’oscillatore interno, che genera la sincronizzazione per tutte le operazioni 
di sistema. Questa temporizzazione principale viene divisa per due per ge- 
nerare la tamporizzazione dei pixel (5.3 MHz) e per tre per fornire il segna- 
le CPUCLK (3.58 MHz solo per TMS 9118). 
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APPENDICE F 



Estratto dal Manuale del generatore programmabile 
di suoni AY-3-8910 

(riprodotto per gentile concessione della General Instruments 
Microelectronics Ltd.) 



1.2 Caratteristiche 

— Completo controllo software della generazione del suono. 

— Interfaccia con la maggior parte dei microprocessori a 8 e 16 bit. 

— Tre uscite analogiche indipendenti. 

— Due porte di I/O ad utilizzo generale su 8 bit (AY-3-8910). 

— Una porta di I/O ad utilizzo generale su 8 bit (AY-3-8912). 

— Alimentazione +5 Volt unica. 



1.3 Scopo del manuale 

Questo manuale si prefigge d’illustrare in che modo programmare il gene- 
ratore programmabile di suoni AY-3-8910/8912 per ottenere i risultati so- 
nori desiderati. Tutti i programmi e i progetti hardware sono stati provati 
allo scopo di verificarne l’applicabilità pratica, anziché solo teorica. 
Sebbene le tecniche presentate consentano di ottenere ottimi risultati, le pos- 
sibilità di generazioni di suoni sono talmente vaste che è corretto conside- 
rare questo manuale solo come un’introduzione alle potenzialità applicati- 
ve del PSG. 



2.2 Assegnazioni dei piedini 

L’AY-3-8910 è un integrato che viene fornito in un package dual-in-line a 
40 piedini che vengono logicamente assegnati come illustrato nella figura 
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PAfiAU.EC I O 



Fig. 1 - Diagramma di sistema tipico. 

4. Viceversa l’AY-3-8912 è un package dual-in-Iine a 28 piedini logicamente 
assegnati come illustrato nella figura 5. 



2.3 Funzioni dei piedini 

DA7-DA0 (ingresso/uscita/alta impedenza): piedini 30-37 (AY-3-8910) 
Dato/Indirizzo 7-0: piedini 21-28 (AY-3-8912) 

Queste otto linee costituiscono il bus di 8 bit bidirezionale usato dal mi- 
croprocessore per inviare al PSG sia dati che indirizzi e per ricevere dati 
dal PSG stesso. Nella modalità dati, DA7— DAO corrispondono ai bit B7— B0 
del vettore dei registri. Nella modalità indirizzo DA3— DAO selezionano il 
numero di registro (0—17 ottale) e DA7— DA4 in unione con gli ingressi di 
indirizzo A9 e A8 formano l’indirizzo d’ordine alto (selezione dell’integrato). 

A8 (ingresso): piedino 25 (AY-3-8910) 
piedino 17 (AY-3-8912) 

A9 (ingresso): piedino 24 (AY-3-8910) 

non disponibile sull’AY-3-8912 

Indirizzo 9, Indirizzo 8 

Questi bit “extra” d’indirizzo sono stati messi a disposizione per poter po- 
sizionare il PSG (occupando uno spazio di memoria di 16 parole) all’inter- 
no di uno spazio di memoria totale di 1024 parole piuttosto che in uno spazio 
di sole 256 parole, così come consentito dal solo utilizzo dei bit di indiriz- 
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Top View 




Vcc <+5V| 

TEST 1 

ANALOG CHANNEL C 

0A0 
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DA2 

DA3 

OA4 

DA5 

DA6 
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BDIR 

TEST 2 

A8 

À9 

RESET 

CLOCK 

IOAO 



Fig. 4 - AY-3-8910 assegnazioni dei piedini. 



ANALOG CHANNEL C C 
TEST 1 C 
Vcc (+5V) C 
ANALOG CHANNEL B 
ANALOG CHANNEL A C 
Vss (GND) C 
IOA7 C 
IOA6 C 
IOA5 C 
JOA4 C 
!OA3 C 
IOA2 C 
IOAl 
IOAf) 




DAO 

DAI 

DA2 

DA3 

DA4 

DA5 

DA6 

DA7 

BCl 

BC2 

BDIR 

AB 

RESET 

CLOCK 



Fig. 5 - AY-3-8912 assegnazioni dei piedini. 



zo DA7--DA0. Se la dimensione della memoria non richiede l’uso di que- 
ste linee d’indirizzo extra, esse possono essere lasciate non connesse poiché 
entrambe sono fornite di un resistore interno all’integrato di tipo “pull-down” 
(A9) o “pull-up” (A8). In un ambiente “rumoroso” si raccomanda di con- 
nettere sia A9 che A8, se non sono usati, rispettivamente alla presa di a 
terra e a +5V. 



RESET (ingresso): piedino 23 (AY-3-8910) 
piedino 16 (AY-3-8912) 
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Per un’inizializzazione logica come quella che avviene al momento dell’ac- 
censione, si deve applicare uno “0” logico (terra) al piedino di RESET: tut- 
ti i registri vengono di conseguenza azzerati. 11 piedino di RESET è fornito 
di un resistore interno all’integrato di tipo “pull-up”. 

CLOCK (ingresso): piedino 22 (AY-3-8910); 

piedino 15 (AY-3-89I2) 



Questo ingresso, compatibile TTL, fornisce la sincronizzazione per i gene- 
ratori di suono, rumore e forma d’inviluppo. 



BDIR, BC2, BC1 (ingressi): piedini 27, 28, 29 (AY-3-8910); 

piedini 18, 19, 20 (AY-3-8912) 

Bus DIRection, Bus Control 1,2 

Questi segnali di controllo del bus vengono generati direttamente da mi- 
croprocessori della serie Gl CP1600 per controllare tutte le operazioni, in- 
terne ed esterne, del bus nel PSG. Usando processori di tipo diverso, questi 
segnali possono essere forniti per mezzo di linee di bus analoghe o simu- 
landoli sulle linee di I/O del processore. 11 PSG decodifica questi segnali 
come qui illustrato: 



BDIR BC2 BCI 

0 0 0 

0 0 1 

0 1 0 

0 1 1 

1 0 0 

1 0 1 

1 1 0 



1 1 1 



Funzione Funzione 

CPI600 PSG 

NACT INATTIVO. Si veda 010 (IAB). 

ADAR INDIRIZZO ALLACCIAMENTO. Si veda 
lll(INTAK). 

IAB INATTIVO. Il bus CPU/PSG è inattivo. 
DA7— DA0 sono nello stato ad alta impe- 
denza. 

DTB LETTURA DAL PSG. Questo segnala fa sì 
che il contenuto del registro indirizzato venga 
messo sul bus PSG/CPU. DA7 — DA0 sono 
in modalità d’uscita. 

BAR INDIRIZZO ALLACCIAMENTO. Si veda 
lll(INTAK). 

DW INATTIVO. Si veda 010. 

DWS SCRITTURA SUL PSG. Questo segnale in- 
dica che sul bus c’è un dato che va connesso 
al registro correntemente indirizzato. DA7— 
DA0 sono in modalità d’ingresso. 

INTAK INDIRIZZO ALLACCIAMENTO. Questo 
segnale indica che sul bus vi è un indirizzo 
a cui la CPU deve allacciarsi nel PSG. 



Quando ci s’interfaccia ad un processore differente dal CP 1600, è suffi- 
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ciente simulare la decodifica sopra riportata; inoltre possono essere sfrut- 
tate le ridondanze dei segnali di controllo del bus rispetto alle funzioni del 
PSG poiché solo quattro tra le possibili funzioni del bus sono utilizzate 
dal PSG. Da ciò si può ricavare una semplificazione della programmazio- 
ne del controllo del bus in cui sono richiesti solo la linea BDIR e BC1, ove 
la linea BC2 è connessa a +5V: 



BDIR BC2 BC1 

0 1 0 

0 1 1 

1 1 0 

1 1 1 



Funzione PSG 
Inattivo 

Lettura dal PSG 
Scrittura nel PSG 
Indirizzo allacciamento 



Canali Analogici A, B, C: (uscite): piedini 4, 3, 38 (AY-3-8910) 

piedini 5, 4i 1 (AY-3-8912) 



Ciascuno di questi segnali è l’uscita di un corrispondente convertitore ana- 
logico/digitale; complessivamente forniscono il segnale che rappresenta la 
complessa forma d’onda del suono generato dal PSG. 



IOA7— IOAO (ingresso/uscita): piedini 14—21 (AY-3-8910) 

piedini 7-14 (AY-3-8912) 

IOB7— IOBO (ingresso/uscita): piedini 6—13 (AY-3-8910) 

non disponibili sull’AY-3-8912 

Ingresso/uscita A7— AO, B7— BO 

Ciascuna di queste due porte d’ingresso/uscita parallele consentono lo scam- 
bio di dati di 8 bit in parallelo da/per il bus CPU/PSG da/a un qualsiasi 
dispositivo esterno connesso ai piedini IOA o IOB. Ciascun piedino è for- 
nito di un resistore “pull-up”, in modo che quando si trovano nella moda- 
lità d’ingresso tutti i piedini hanno normalmente il segnale alto. Il metodo 
raccomandato quindi per la scansione di selettori esterni è quello di mette- 
re a terra il bit d’ingresso. 

TEST 1: piedino 39 (AY-3-8910) 
piedino 2 (AY-3-8912) 

TEST 2: piedino 26 (AY-3-8910) 

non connesso nell’AY-3-8912; 

Questi piedini sono usati a scopi di controllo dalla General Instruments 
e devono quindi essere lasciati aperti. 

V (CC): piedino' 40 (AY-3-8910) 

piedino 3 (AY-3-8912) 

Alimentazione nominale +5 Volt del PSG. 

V (SS): piedino 1 (AY-3-8910) 

piedino 6 (AY-3-8912) 

Riferimento di terra per il PSG. 
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2.4 Temporizzazione del bus 

Poiché le funzioni del PSG sono controllate per mezzo di comandi dal pro- 
cessore di sistema, il bus comune tra dati ed indirizzi (DA7-DA0) richiede 
di essere definito in dipendenza dalla funzione attiva in un dato momento. 
Questa condizione viene soddisfatta attraverso i segnali di controllo stan- 
ziati dal processore, descritti in precedenza, che definiscono lo stato del 
bus; il PSG decodifica quindi questi segnali per effettuare la funzione ri- 
chiesta. 

L’impostazione di questi segnali di controllo da parte del processore è la 
medesima del caso in cui il processore interagisce con una RAM: (1) il pro- 
cessore imposta l’indirizzo di memoria; (2) il processore scrive o legge il 
dato sulla/dalla memoria. Nel nostro caso la memoria è il vettore dei 16 
registri lettura/scrittura di controllo del PSG. 

Le relazioni temporali nelle istanze dei segnali di controllo del bus vengo- 
no esaminate in generale dalla seguente sezione, e in dettaglio nella sezione 
7, “Specifiche elettriche”. 



Fig. 3 - Vettore registri del PSG. 



BIT 

REGISTRO 


B7 


B6 


B5 


B4 


B3 


B2 


B1 


BO 


RO 


Periodo suono canale A 




RI 




R2 


Periodo suono canale B 
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8 bit regolazione accurata 


R14 
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ATT. 
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Mem. dato porta B di I/O 


I/O parallelo 8 bit sulla porta B 
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Fig. 23 ■ Scala cromatica di temperamento equafile (frequenza temporizzazione = 1.78977 MHz). 




3. Guida operativa 

Poiché tutte le funzioni del PSG sono controllate dal processore ospite per 
mezzo di una serie di caricamenti dei registri, una descrizione dettagliata 
delle operazioni del PSG può ottenersi ponendo in relazione ciascuna fun- 
zione con il valore di controllo impostato nell’opportuno registro. La crea- 
zione di un programma per ottenere un particolare suono o effetto sonoro 
segue la sequenza di controllo che viene riportata di seguito: 



Sezione 


Operazione 


3.1 


Controllo del gene- 
ratore di suono 


3.2 


Controllo del gene- 
ratore di rumore 


3.3 


Controllo del mixer 


3.4 


Controllo 

d’ampiezza 


3.5 


Controllo generatore 
d’inviluppo 



Registri 


Funzione 


R0-R5 


Programmazione dei 
periodi del suono 


R6 


Programmazione del 
periodo del rumore 


R7 


Abilita suono e/o 
rumore sui canali 
selezionati 


R10-R12 


Seleziona ampiezze fisse 
o a inviluppo variabile 


R13-R15 


Programmazione del 
periodo d’inviluppo 
e scelta della forma 
d’inviluppo 



3.1 Controllo generatore di suono (registri RO, RI, R2, R3, R4, R5) 



La frequenza di ciascuna onda quadra prodotta dai tre generatori di suono 
(uno per ogni canale A, B, C) viene ottenuta nel PSG dapprima dividendo 
per 16 all’ingresso del CLOCK e poi dividendo ulteriormente il risultato 
per il valore del periodo del suono programmato su 12 bit. Ciascun valore 
su 12 bit viene ottenuto nel PSG combinando il contenuto dei registri di 
regolazione di massima e di regolazione accurata, come illustrato nella fi- 
gura che segue: 

Registri regolazione Registri regolazione 

di massima Canale accurata 



RI A 

R3 B 

R5 C 



RO 

R2 

R4 



BMB6 BS 0} 32 B* 60 



B7 B6 es 04 B3 82 Bi | 90 



jTPlilTPiol TP9 I TP» | TPZ | TP6 j TP5 j TP4 | TF3 | TP2 | TP! | TPQ | 

Periodo del suono (12 bit) al generatore di tono 
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Si noti che il valore su 12 bit ottenuto dalla combinazione dei due registri 
di regolazione indica un PERIODO - più alto è questo valore e minore sa- 
rà la frequenza. 

Si noti inoltre che a causa della tecnica adottata per il calcolo del periodo 
del suono, il valore più basso è 000000000001 (divide per 1) mentre quello 
più alto è 111111111111 (divide per 4095). 

Le equazioni che descrivono le relazioni tra la frequenza desiderata del suono 
in uscita e la frequenza d’ingresso del CLOCK e del periodo del suono so- 
no le seguenti: 

(a) f T = — Ct ° CK (b) TPio = 256CT.O + FT 10 

16TP 10 



dove: 

fT = frequenza di suono desiderata 
fcLocK = frequenza del CLOCK in ingresso 

TP io = decimale equivalente ai bit del periodo del suono TP11-TP0 
CTio = decimale equivalente ai bit B3-B0 del registro di regolazione di 
massima (TP11--TP8) 

FT io = decimale equivalente ai bit B7— B0 del registro di regolazione ac- 
curata (TP7--TP0). 

Dalle equazioni di cui sopra si può dedurre che la frequenza di suono può 
variare da un estremo inferiore di F(CLOCK)/65520 (con TPio = 4095io) 
ad un estremo superiore F(CLOCK)/16 (con TP] 0 = 1). Se si usa un tempo- 
rizzatore in ingresso che funziona a 2MHz, per esempio, si può ottenere 
un intervallo di frequenza tra 30,5 Hz a 125KHz. 

Per calcolare i valori da impostare nei registri di regolazione di massima 
del periodo del suono e di regolazione accurata dello stesso, conoscendo 
l’ingresso del CLOCK e la frequenza di uscita desiderata, è sufficiente ma- 
nipolare le equazioni viste prima, ottenendo: 



(a) TP io 



frLOCK 

16 f T 



Esempio 1 

f T = lKHz 
fcLocK = 2MHz 



TP io 



2x IO 6 
16(1 x IO 3 ) 



125 



(b) CT,o + 



FT io 
256 



TP io 
256 
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Sostituendo nell’equazione (b): 



CT io + 



FT, 0 

256 



125 

256 



da cui: 

CT 10 = 0 =0000 (B3--B0) 

FTio = 125,0 = 01111101 (B7-B0) 



Esempio 2 

fi = 100 Hz 
fcLOCK - 2MHz 



TPio 



2x IO 6 
16(1 X IO 2 ) 



1250 



Sostituendo nell’equazione (b): 

FT io 1250 . 226 

CTio + ■ — = = 4 + 

256 256 256 

da cui: 

CT io = 4,o = 0100 (B3-B0) 

FT, 0 = 226,0 = 11100010 (B7-B0) 



3.2 Controllo del generatore di rumore (registro R6) 

La frequenza della sorgente di rumore viene ottenuta nel PSG dapprima 
dividendo per 16 il segnale di CLOCK in ingresso, poi dividendo ulterior- 
mente il risultato per il valore programmato su 5 bit del periodo del rumo- 
re. Questo valore è contenuto nei 5 bit meno significativi del registro R6 
(B4— B0), come viene illustrato di seguito 



Periodo del rumore, 
REGISTRO 6 



B7 


B6 


B5 


B4 


B3 


B2 


B1 


B0 
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NON 

USATI 



NP (Periodo rumore) 
al generatore di rumore 





Si noti che il valore su 5 bit è un periodo: quindi più alto è questo valore 
e minore sarà la frequenza di rumore risultante. Si noti anche che, come 
per il periodo del suono, il valore più basso è 00001 (divide per 1) e quello 
più alto è 11111 (divide per 31). 

L’equazione per la frequenza del rumore è la seguente: 



r fcLOCK 

in = 

16 NP,o 



Dove: 

fN = frequenza di rumore desiderata 
fcLOCK = frequenza del CLOCK in ingresso 

NPio = decimale equivalente ai bit B4-B0 del registro del periodo del ru- 
more. 

Dalla precedente equazione si può dedurre che la frequenza del rumore può 
variare da un estremo inferiore di fci.ocK/496 (per NPi 0 = 31 to) a un estre- 
mo superiore di fcLocic/16 (per NP| 0 = 1). Se si usa un ingresso di CLOCK 
di 2MHz, per esempio, è possibile produrre una frequenza di rumore com- 
presa tra 4KHz e 125 KHz. 

Per calcolare il valore da impostare nel registro di periodo del rumore, co- 
noscendo l’ingresso del CLOCK e la frequenza desiderata in uscita per il 
rumore, basta manipolare l’equazione di cui sopra nel seguente modo: 



NP io 



fcLOCK 

16 f N 



3.3 Controllo del mixer - Abilitazione dell’I/O (registro 7) 

Il registro 7 è un registro di abilitazione multifunzione che controlla i tre 
mixer suono/rumore e le due porte di I/O di uso generale. 

I mixer, come accennato in precedenza, combinano le frequenze del tono 
e del rumore per ciascuno dei tre canali. La decisione di combinare tono 
e rumore o nessuno dei due per ciascun canale viene memorizzata dai bit 
B5--B0 del registro R7. 

La direzione (ingresso o uscita) delle due porte di I/O ad uso generale (IOA 
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e ÌOB) viene memorizzata dallo stato dei bit B7 e B6 del medesimo registro. 
Queste funzioni vengono illustrate qui di seguito: 



ConiroHo del mixer Abitazione I/O 
Registro R7 




Tavola di verità per 
l’abilitazione del rumore 



Rumore abili- 
tato sul canale 



Bit di R7 
B5 B4 B3 

0 0 0 

0 0 1 

0 1 0 

0 1 1 

1 0 0 

1 0 1 

1 1 0 

1 1 1 



C B A 

C B — 

C — A 

C — — 

— B A 

— B — 

— — A 



Tavola di verità per 
l’abilitazione de! tono 
Bit di R7 



B2 B1 B0 
0 0 0 
0 0 1 
0 1 0 
0 1 1 
1 0 0 
I 0 1 
1 1 0 
1 1 1 



Tono abilita- 
to sul canale 
C B A 
C B — 
C — A 
C — — 
— B A 
— B — 
— — A 



Tavola di verità per la porta di I/O 



Bit di R7 


Stato porta I/O 


B7 


B6 


IOB 


IOA 


0 


0 


Input 


Input 


0 


1 


Input 


Output 


1 


0 


Output 


Input 


1 


1 


Output 


Output 



Nota: La disabilitazione del suono e del rumore non “spegne” un canale. Questa 
operazione può essere compiuta solo scrivendo tutti 0 nel corrispondente registro 
di controllo d’ampiezza (RIO, RII e R12; si veda 3.4). 
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3.4 Controllo d’ampiezza (registro RIO, RII, R12) 

L’ampiezza dei segnali generati da ciascuno dei tre convertitori D/A (uno 
per ogni canale. A, B e C) è determinata da cinque bit meno significativi 
(B4— BO) dei registri RIO, RII e R12 come illustrato: 



Controllo dell’ampiezza 



Num. registro Canale 

RIO A 

RII B 

R12 C 



| B 7 1 B6 1 B5 | E< | B3 | B? | B i [ Bo| 

"~NON~~ I I S 

/À \ 

0 

"Modo" Livello d'ampiezza 
d'ampiezza fissato 4 bit 



La “modalità” d’ampiezza (bit M) determina se l’ampiezza deve essere fis- 
sa (M = 0) oppure se il suo livello deve essere variabile (M = l). Ovviamente 
da ciò consegue che i bit L3— LO che definiscono il valore di un’ampiezza 
fissa hanno significato solo nel caso in cui M = 0. In questo caso il livello 
dell’ampiezza è “fissato” solo nel senso che esso è sotto controllo diretto 
del processore di sistema (attraverso i bit D3— DO). La modifica dell’am- 
piezza quando si è nella modalità “fissa” comporta in ogni istante l’inter- 
vento del processore di sistema attraverso una sequenza indirizzo di allac- 
ciamento/dato da scrivere per modificare il contenuto di D3-D0. 
Quando M = 1 (livello d’ampiezza variabile), l’ampiezza di ciascun canale 
è determinata dal modello d’inviluppo così come è definito dai quattro bit 
di output E3, E2, E1 e EO del generatore d’inviluppo. 

La “modalità” d’ampiezza (bit M) può essere anche pensata come un bit 
di “abilitazione dell’inviluppo”; cioè quando M = 0 esso non viene usato, 
e viceversa è abilitato quando M = l. Una descrizione completa della fun- 
zione del generatore d’inviluppo segue nella sezione 3.5. 

Il diagramma completo che descrive tutte le combinazioni dei 5 bit del con- 
trollo d’ampiezza è mostrato di seguito: 
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Numero registro 
controllo d’ampiezza 
RIO 
RII 
R12 



B7 


B6 


DJ 

LA 


B4 


B3 


B2 


B1 


B0 



▼ t Y t t 

M L3 L2 LI LO 

0 0 0 0 0 



Olili 



NON 

USATI 



Canale 

A 

B 

C 



Output 
controllo 
ampiezza 
0 0 0 0 



Ampiezza ad uno 
dei 16 livelli 
determinati da L3 
L2 LI LO 



1 X X X X 



Ì Ampiezza variabile 
su 16 livelli deter- 
minati dall’uscita 
del generatore 
d’inviluppo 



(X = non significativo) 



La Figura 6 illustra graficamente la selezione di un’ampiezza 'a livello va- 
riabile (controllata dall’inviluppo) dove i 16 livelli sono in diretta corrispon- 
denza con l’uscita del generatore d’inviluppo. Un’ampiezza a livello “fissa- 
to” corrisponderebbe a uno solo di questi livelli, quello determinato dal 
decimale equivalente alla configurazione dei bit L3, L2, LI e LO. 




Fig. 6 - Controllo d'ampiezza variabile (M - 1). 
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3.5 Controllo del generatore d’inviluppo (registri R13, R14, R15) 

Per ottenere la generazione di modelli d’inviluppo piuttosto complessi, nel 
PSG sono disponibili due metodi indipendenti di controllo. Con il primo 
è possibile variare la frequenza dell’inviluppo usando i registri R13 e R14; 
con il secondo la forma relativa e la forma del ciclo dell’inviluppo possono 
essere variate usando il registro R15. Nei seguenti paragrafi verranno illu- 
state nei dettagli le funzioni di controllo dell’inviluppo: dapprima si parle- 
rà del controllo del periodo e poi del controllo della forma/ciclo. 



3.5.1 Controllo del periodo dell’inviluppo (registri R13, R14) 



La frequenza dell’inviluppo viene calcolata, nel PSG, dapprima dividendo 
per 256 l’ingresso di CLOCK, quindi dividendo ulteriormente il risultato 
dal valore a 16 bit programmato come periodo d’inviluppo. Nel PSG que- 
sto valore su 16 bit viene ottenuto combinando i contenuti dei registri di 
regolazione accurata e di massima dell’inviluppo, come illustrato di seguito: 



Regolazione di massima Regolazione accurata 

dell'inviluppo dell'inviluppo 

registro R14 registro R13 



| B? | 66 |b5 | B* j B3 j B2 [ B T | BO | [ B~ | B6 [ BS | B* | B3 | B2 | B l [ BO ) 




[EPis]EPt4|EPt3|ePl2|EPn[EPio{ £P? | EPE | £P7 | EPS ) EPS [ EP4 ] £P3 | EP2 | £P1 | E PO | 



Periodo dell'inviluppo (EP) su 16 bit 
ai generatore d'inviluppo 



Si noti che il valore programmato su 16 bit nei registri suddetti è un perio- 
do: più alto è questo valore e minore sarà la frequenza d’inviluppo che si 
ottiene. 

Si noti inoltre che, come per il periodo del Tono, il valore minimo è 
0000000000000001 (divide per 1) e quello massimo è 1111111111111111 (divi- 
de per 65535 io). 

Le equazioni che regolano la frequenza d’inviluppo sono: 



X f | r\r ir 

(a) f E = — (b) EPio = 256CTio + FT, 0 

256EP.O 



Dove: 

f E è la frequenza d’inviluppo voluta 
fcLocK è la frequenza dell’ingresso di CLOCK 
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EPio è il decimale equivalente ai bit del periodo d’inviluppo EP15— EPO 
CTio è il decimale equivalente ai bit B7--B0 (EP15 — EP8) del registro di 
regolazione di massima 

FT [o è il decimale equivalente ai bit B7-B0 (EP7-EP0) del registro di re- 
golazione accurata. 

Da queste equazioni si può dedurre che la frequenza d’inviluppo varia tra 
un estremo inferiore di fcLocK/16776960 (dove EPio = 65535 io) a un estremo 
superiore di fcLock/256 (dove EPio = 1). Usando per esempio un clock 
a 2MHz si ottiene un intervallo per la frequenza d’inviluppo da 0,12 Hz 
a 7812,5 Hz. 

Per calcolare i valori contenuti nei registri di regolazione di massima e ac- 
curata del periodo d’inviluppo, conoscendo il CLOCK d’ingresso e la fre- 
quenza che si desidera ottenere, è sufficiente manipolare come segue le equa- 
zioni viste prima: 



(a) EPio = 



fcLQCK 

256f E 



(b) CT io + 



FT io 
256 



EPio 

256 



Esempio: 
f E = 0,5 Hz 
fcLOCK = 2 MHz 

™ 2xl0 6 

EPio = 

256(0,5) 



15.625 



Sostituendo nell’equazione (b): 

CTio + = ÌM25 = 6J + JL 

256 256 256 

da cui si ricava: 

CT,o = 61,o = 00111101 (B7--B0) 

FT, 0 = 9,o = 00001001 (B7-B0) 



3.5.2 Controllo forma/ciclo dell’inviluppo (registro R15) 

Il generatore d’inviluppo divide inoltre la frequenza d’inviluppo per 16 pro- 
ducendo un modello d’inviluppo a 16 stati per ciclo così com’è definito dal 
suo contatore su 4 bit, E3 E2 E1 e E0. La particolare forma e modello di 
ciclo di un qualsiasi inviluppo voluto viene ottenuta controllando il mo- 
dello di conteggio (incremento o decremento) del contatore su 4 bit e defi- 
nendo un modello a singolo-ciclo o a ciclo-ripetuto. 
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Questo controllo forma/ciclo viene memorizzato nei 4 bit meno significa- 
tivi (B3 - BO) del registro RI 5. Ciascuno di questi bit controlla una funzio- 
ne del generatore d’inviluppo, nel modo di seguito illustrato: 



Registro controllo (R15) 
Forma/Ciclo d’inviluppo 



B7 


B6 


B5 


B4 


B3 


B2 


B1 


B0 



~NON~ 

USATI 



Funzione 

Sostegno 

Alternato 

Attacco 

Continuo 



> al generatore 
d’inviluppo 



La definizione di ogni funzione è la seguente: 

Sostegno - Quando vale 1, limita l’inviluppo a un solo ciclo mantenendo 
l’ultimo valore del contatore d’inviluppo (E3--E0 = 0000 olili secondo 
la modalità del contatore (incremento o decremento, rispettivamente). 
Alternato - Quando vale 1 il contatore d’inviluppo inverte la modalità di 
conteggio dopo ogni ciclo. 

Nota: quando sono a 1 sia il bit Sostegno che quello Alternato, il contatore 
d’inviluppo viene rinizializzato prima della memorizzazione dell’ultimo va- 
lore. 

Attacco - Quando vale 1 il contatore d’inviluppo si incrementerà (attacco) 
da E3 E2 E1 EO = 0000 a E3 E2 E1 E0 = 1111. Viceversa quando vale 
zero il conteggio andrà da 1111 a 0000. 

Continuo - Quando vale 1 il modello del ciclo è definito dal bit di Soste- 
gno. Quando vale 0 il generatore d’inviluppo si rinizializzerà a 0000 dopo 
ogni ciclo e manterrà quel valore. 

Un’ulteriore descrizione delle funzioni accennate potrebbe essere ottenuta 
con numerosi diagrammi in cui illustrare le sequenze di conteggio binario 
per ogni combinazione di Sostegno, Alternato, Attacco e Continuo. Poi- 
ché però queste uscite vengono usate (quando selezionate dai registri di con- 
trollo d’ampiezza) per modulare in ampiezza le uscite dai mixers, una mi- 
glior comprensione dei loro effetti può ottenersi attraverso una rappresen- 
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tazione grafica dei loro valori per ogni condizione selezionata, come illu- 
strato nelle figura 7 e 8. 




Fig. 7 - Controllo forma/ciclo dell'inviluppo. 



14 




Fig. 8 - Dettaglio di due cicli della figura 7 (forma d’onda "1010"). 
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6 Generazione di suoni musicali 



Il PSG viene usato principalmente per produrre suoni non musicali come 
effetti che accompagnino l’azione visiva. Nelle seguenti sezioni vengono de- 
scritte delle tecniche e vengono forniti esempi per la creazione degli effetti 
più famosi ed utilizzati. Tutti gli esempi fanno riferimento a un temporiz- 
zatore funzionante a 1,78977 MHz. 



6.1 Effetti di solo suono 

Molti effetti sono producibili usando solamente le capacità di generazione 
di suono del PSG, senza cioè il rumore o la generazione d’inviluppo. Esempi 
di effetti di questo genere sono le frequenze di un suono di segnale telefo- 
nico (due frequenze distinte prodotte simultaneamente) o l’effetto della si- 
rena europea (due frequenze distinte prodotte sequenzialmente): segue la 
lista dei valori dei registri di controllo atti all’ottenimento degli effetti citati. 



Fig. 27 - Diagramma per l’effetto “Sirena europea” 



Numero Valore ottale Spiegazione 

registro da caricare 



Tutti i non specif. 000 

R0 376 > 

RI 000) 

R7 076 

RIO 017 



(attendere circa 
R0 126 > 

RI 001 1 

(attendere circa 
RIO 000 



Periodo suono canale A = 2.27 ms 
(440 Hz) 

Abilita solo suono canale A 
Seleziona massima ampiezza canale A 
350 ms prima di continuare) 

Periodo suono canale A = 5,346 ms 
(187Hz) 

350 ms prima di continuare) 

Spegne canale A; termina l’effetto 



6.2 Effetti di solo' rumore 

Alcuni degli effetti sonori più comunemente richiesti implicano l’uso del 
generatore di rumore e del generatore d’inviluppo (oppure il controllo da 
parte del processore dell’inviluppo di canale se altri canali stanno usando 
il generatore d’inviluppo). 



239 




Esempi di quanto detto sono gli effetti “sparo” ed “esplosione”, che ven- 
gono illustrati nelle figure 28 e 29. In entrambi i casi viene usato solo il 
rumore con un inviluppo di decadimento. Negli esempi riportati le uniche 
differenze sono la lunghezza dell’inviluppo, modificata attraverso il regi- 
stro di regolazione di massima, e il periodo del rumore. Si noti che una 
“esplosione” significativamente minore può essere ottenuta con tutti e tre 
i canali che operano con gli stessi parametri. 



Fig. 28 - Diagramma per l'effetto "sparo" 



Numero 

registro 


Valore ottale 
da caricare 


Spiegazione 


Tutti i non specif. 


000 


— 


R6 


017 


Valore medio per periodo rumore 


R7 


007 


Abilita solo rumore su A, B, C 


RIO 


020 


Seleziona intervallo completo 


RII 


020 


d’ampiezza sotto controllo diretto 


R12 


020 


del generatore inviluppo 


RI4 


020 


Periodo inviluppo 0,586 secondi 


R15 


000 


Seleziona inviluppo di decadimento 
un solo ciclo 



Fig. 29 - Diagramma 


dell’effetto ' 


‘esplosione” 


Numero Valore ottale 

registro da caricare 


Spiegazione 


Tutti i non specif. 


000 


— 


R6 


000 


Imposta il periodo del rumore 
al massimo valore 


R7 


007 


Abilita solo il rumore canali A, B, C 


RIO 


020 


Seleziona intervallo completo 


RII 


020 


d’ampiezza sotto controllo diretto 


R12 


020 


del generatore inviluppo 


R14 


070 


Imposta periodo inviluppo a 2,05 sec. 


R15 


000 


Seleziona inviluppo di decadimento 
un solo ciclo 



6.3 Effetti con variazione continua di frequenza 

Gli effetti sonori “laser”, “sibilo di bomba”, “ululato del lupo” e “auto da 
corsa” (illustrati nelle figure dalla 30 alla 33) utilizzano effetti di variazio- 
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ne continua della frequenza. In tutti i casi si opera un incremento o un de- 
cremento dei valori contenuti nei registri di periodo del suono in base a 
un inizio, una fine e un tempo tra i cambiamenti di frequenza, di volta in 
volta diversi. Per esempio la variazione dell’effetto laser è molto più rapida 
dell’effetto accelerazione dell’auto da corsa: ciò nonostante usano, con dif- 
ferenti parametri, la stessa routine. 

Altri risultati facilmente ottenibili sono delle variazioni continue di rumo- 
re o l’effetto doppler. La variazione continua del registro di temporizzazio- 
ne del rumore (R6) produce un effetto doppler che sembra particolarmen- 
te adatto ai giochi di tipo “guerre stellari”. 



Fig. 30 - Diagramma effetto sonoro "laser” 



Numero 


Valore ottale 


Spiegazione 


registro 


da caricare 




Tutti i non specif. 


000 


— 


R7 


076 


Abilita il suono solo sul canale A 


RIO 


017 


Massima ampiezza canale A. 

Effetto variazione continua (sweep) sul 
periodo suono canale A con ciclo 


RO 


060 (inizio) 


processore, con tempo attesa ca. 3 ms 


RO 


160 (fine) 


tra ogni passo da 060 a 160 

(da 0,429 ms/2330 Hz a 1 ms/1000 Hz) 


RIO 


000 


Spegne canale A: l’effetto termina 



Fig. 31 - Diagramma 


effetto sonoro 


"sibilo di una bomba” 


Numero 


Valore ottale 


Spiegazione 


registro 


da caricare 




Tutti i non specif. 


000 


— 


R7 


076 


Abilita il suono solo sul canale A 


RIO 


017 


Massima ampiezza canale A. 

Effetto variazione continua (sweep) sul 
periodo suono canale A con ciclo 


R0 


060 (inizio) 


processore, con tempo attesa ca. 25 ms 


R0 


300 (fine) 


tra ogni passo da 060 a 300 

(da 0,429 ms/2330 Hz a 1,72 ms/582 Hz) 


RIO 


000 


Spegne Canale A: l’effetto termina 



Al termine del ciclo proseguire con la sequenza in figura 28 
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6.4 Effetti multicanale 



Grazie all’indipendenza architetturale del PSG, molti effetti piuttosto com- 
plessi sono ottenibili senza sovraccaricare il processore. Per esempio, l’ef- 
fetto “ululato del lupo” illustrato nella Figura 32 mostra l’uso di due cana- 
li per aggiungere un rumore costante di fiato ansimante alle tre variazioni 
continue di frequenza concentrate nell’ululato vero e proprio. Una volta 
che questo rumore è mandato sul canale, il processore deve solo effettuare 
la variazione continua della frequenza. 



Fig. 32 - Diagramma per l’effetto sonoro "ululato de I lupo" 



Numero 


Valore ottale 


Spiegazione 


registro 


da caricare 




Tutti i non specif. 


000 


— 


R6 


001 


Valore minimo periodo rumore 


R7 


056 


suono canale A, rumore canale B 


RIO 


017 


Massima ampiezza canale A 


RII 


011 

( 


Ampiezza minore canale B. 

Effetto variazione continua sul periodo 
i suono canale A con ciclo processore, 


RO 


100 (inizio) < 


con tempo attesa 12 ms ca. 


RO 


040 (fine) | 


tra ogni passo da 100 a 040 

(da 0,572 ms/1748 Hz a 0,286 ms/3496 Hz) 


(Attendere circa 150 ms prima di proseguire) 


RO 


100 (inizio) ( 


'Ciclo del processore con tempo 25 ms ca. 


RO 


060 (fine) • 
1 


tra ogni passo da 100 a 060 
((da 0,572 ms/1748 Hz a 0,429 ms/233 Hz) 


RO 


060 (inizio) | 


(Ciclo del processore con tempo ca. 6 ms 


RO 


150 (fine) 


(tra ogni passo da 060 a 150 

((da 0,429 ms/233 Hz a 0,930 ms/1075 Hz) 


RIO 

RII 


000 f 
000 \ 


Termina l’effetto spegnendo canali A e B 
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Fig. 33 - Diagramma per l’effetto sonoro "auto da corsa” 



Numero 


Valore ottale 


Spiegazione 


registro 


da caricare 




Tutti i non specif. 


000 


— 


R3 


017 


Periodo suono canale B 34,33 ms/29 Hz 


R7 


074 


Abilita suono su canali A e B 


RIO 


017 


Massima ampiezza canale A 


RII 


012 


Ampiezza minore canale B. 
/ Effetto variazione continua 


♦R1/R0 


013/000 (inizio) 


\con ciclo processore, con tempo attesa di 


•R1/R0 


004/000 (fine) 


)3 ms ca. tra ogni passo da 013/000 a 004/000 
\(da 25,17 ms/39,7 Hz a 9,15 ms/109,3 Hz). 
Effetto variazione continua con ciclo 


•R1/R0 


011/000 (inizio) 


processore, con tempo attesa ca. 3 ms 


•R1/R0 


003/000 (fine) 


tra ogni passo da 011/000 a 003/000 
(da 20.6 ms/48.5 Hz a 6.97 ms/145.6 Hz). 
Effetto variazione continua con ciclo 


•R1/R0 


006/000 (inizio) 


processore con tempo attesa ca. 6 ms 


*R1/R0 


001/000 (fine) 


tra ogni passo da 006/000 a 001/000 
(da 13,73 ms/72,8 Hz a 2,29 ms/436,7 Hz) 


RIO 

RII 


000 

OOO 


Termina l’effetto spegnendo canali A e B 



* Decrementa R0/R1 come numero intero, cioè parte da 013/000, prosegue con 
012/377, poi ancora 012/376 ecc. 
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Un compagno insostituibile per gii utilizzatori di com- 
puter MSX, Questo non è un libro per principianti, 
ma si rivolge a programmatori che operano sui com- 
puter MSX, spiegando esattamente come funziona- 
no e come possono essere utilizzati al meglio. 

La prima parte riguarda la progettazione di sistemi, 
la relazione fra linguaggio BASIC e MSX e l'intro- 
duzione al codice macchina. 

Nella seconda parte viene illustrato l'impiego del- 
l'Assembly nei computer MSX con particolare riguar- 
do al processore Video, al Sound Chip di cui è dota- 
ta la macchina e alle funzioni di input/output* 




a 

O 

O 

O 






* mmm. 
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03 
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O 
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